# Bitcoin AI Assistant

The ultimate small form factor Bitcoin AI assistant, designed to run on Intel NUC hardware.

## Overview

A specialized AI assistant trained on comprehensive Bitcoin documentation, including:
- All BIPs (Bitcoin Improvement Proposals)
- Lightning Network protocol specifications (BOLTs)
- LND (Lightning Network Daemon) documentation
- CLN (Core Lightning) documentation
- Bitcoin Core documentation
- Mining guides and technical documentation
- Wallet security best practices
- Bitcoin scripting and protocol details

## System Requirements

**Training Machine:**
- CPU: Ryzen 9 9900X (12C/24T)
- RAM: 60GB
- Storage: 500GB+ free space

**Deployment (NUC):**
- CPU: Intel i5-7260U
- RAM: 31GB
- Storage: 50GB+ free space
- Network: Public IPv4/IPv6 + Tailscale

## Quick Start

1. **Collect Documentation**
```bash
cd data
python3 bitcoin_doc_collector.py
```

2. **Process for Training**
```bash
cd data
python3 process_for_training.py
```

3. **Fine-Tune Model**
```bash
cd training
python3 finetune_cpu.py
```

4. **Deploy to NUC**
```bash
cd nuc_deployment
bash deploy_nuc.sh
```

## Architecture

- **Base Model:** Qwen2.5-7B-Instruct
- **Fine-Tuning:** QLoRA with 4-bit quantization
- **Inference:** llama.cpp with GGUF format
- **Interface:** Flask web server with REST API

## API Endpoints

- `GET /health` - Health check
- `POST /chat` - Bitcoin operations chat
- `POST /complete` - Raw text completion

## Development Status

- [x] Data collection pipeline
- [x] Training script
- [x] NUC deployment setup
- [ ] Model conversion utilities
- [ ] Web interface frontend
- [ ] Production testing

## License

MIT