hdfc-ai 1.0.0

HDFC_AI — Smart Coding Assistant like Aider

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

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:

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:

# 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:

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:

pip show hdfc-ai

License

MIT License — free to use and modify.