Metadata-Version: 2.1
Name: hdfc-ai
Version: 1.0.1
Summary: HDFC_AI — Smart Coding Assistant like Aider
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: rich>=14.0.0
Requires-Dist: requests>=2.30.0
Requires-Dist: litellm>=1.0.0
Requires-Dist: strands-agents>=1.0.0
Requires-Dist: strands-agents-tools>=0.5.0
Requires-Dist: llama-cpp-python>=0.3.0

# HDFC_AI — Smart Coding Assistant

A smart AI coding assistant like Aider that runs locally on your machine.
No data is ever sent to external servers.

## Install

```bash
pip install hdfc-ai
```

## Requirements

- Python 3.10+
- A local GGUF model file (download from huggingface.co/models?search=gguf)

## First Time Setup

On first run HDFC_AI will ask for your model path:

```
🔧 HDFC_AI First Time Setup
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Detected OS: WINDOWS

Example path: C:\Users\you\models\gemma.gguf

📁 Enter your model path: C:\models\gemma.gguf
🌐 Server URL (press Enter for default): 
✅ Setup complete! Starting HDFC_AI...
```

## Usage

Go to any project folder and run:

```bash
cd your-project
hdfc_ai
```

## What HDFC_AI Can Do

| Command | What happens |
|---|---|
| `read the models.py file` | Reads and summarizes that specific file |
| `fix bugs in views.py` | Analyzes, shows diff, asks Y/N before fixing |
| `write a python script for X` | Generates new code from scratch |
| `create a flask project structure` | Creates full folder structure |
| `how many files do you have?` | Shows project info |
| `what is this project about?` | Summarizes the project |
| `exit` | Quit |

## Agent Flow

```
Your Prompt
    ↓
🧠 PLANNER   → creates a plan, asks your approval
    ↓
📖 READER    → reads only relevant files
    ↓
🔍 ANALYZER  → analyzes code based on plan
    ↓
✍️  WRITER    → prepares changes
    ↓
📝 REPORTER  → shows diff, asks Y/N before applying
```

## Supported Languages

Python, Java, JavaScript, TypeScript, C, C++, C#, Go, Rust, HTML, CSS, Markdown

## Reset Config

Delete config file to reconfigure with a new model:

```bash
# Windows
del %USERPROFILE%\.hdfc_ai\config.json

# Mac/Linux
rm ~/.hdfc_ai/config.json
```

## Privacy & Security

- All processing done locally on your machine
- No data sent to any external server
- No telemetry or tracking
- Config stored securely in ~/.hdfc_ai/config.json
- On Mac/Linux config file is chmod 600 (owner read only)
- Original files backed up as .bak before any changes
- Diff shown before applying any changes — you always approve first

## Troubleshooting

**Model not found error:**
```bash
rm ~/.hdfc_ai/config.json
hdfc_ai
```

**Server not starting:**
- Make sure your GGUF model path is correct
- Make sure you have enough RAM (at least 8GB recommended)

**Command not found:**
```bash
pip show hdfc-ai
```

## License

MIT License — free to use and modify.
