BuddAI/archive/QUICKSTART.md

BuddAI Quick Start Guide

You Are Here: Milestone 1 Complete! 🎉

You've successfully:

• ✅ Installed Ollama
• ✅ Downloaded DeepSeek model
• ✅ Had first conversation with base model

Next: Add Persistent Memory

Step 1: Set Up Files

1. Copy these files to your BuddAI folder:

   • buddai.py (the main script)
   • requirements.txt (dependencies - currently none needed!)
   • README.md (the manifesto you already have)

2. Create data directory:

   mkdir data
   

   (Note: If you see an error saying the item already exists, you can safely ignore it and proceed.)

Step 2: Run BuddAI with Memory

Instead of running raw Ollama, now run:

python buddai.py

What happens:

• BuddAI starts with persistent memory enabled
• Conversation history saves to SQLite database
• Context from previous messages is maintained
• Session statistics are tracked

Step 3: Test Memory

First conversation:

James: My name is James Gilbert. I'm building GilBots - modular combat robots.

BuddAI: [Acknowledges and responds]

James: exit

Second conversation (later or tomorrow):

python buddai.py

James: What am I building?

BuddAI: [Should reference GilBots from previous session!]

That's persistent memory working!

---

Available Commands

While in BuddAI:

• /help - Show all commands
• /stats - View session statistics
• /history - See recent conversation
• /clear - Start fresh (clear context)
• /export - Save session to JSON
• exit or quit - End session

---

What You Can Do Now

Test Code Generation

James: Generate ESP32 code for controlling two DC motors via L298N driver with PWM speed control

Test Memory

James: Remember: I prefer modular code with clear comments. Keep functions under 50 lines.

Later:

James: Write a function to control a servo

It should remember your style preference!

Test Context

James: I'm building a flipper mechanism for GilBot #1

James: What servo should I use?

James: How much torque do I need?

BuddAI maintains context across the conversation.

---

Troubleshooting

"Ollama not found"

Make sure Ollama is in your PATH. Test with:

ollama list

"Model not found"

The script will try to download it automatically. Or manually:

ollama pull deepseek-coder:1.3b

"Python not found"

Install Python 3.8+ from python.org

Database errors

Delete data/conversations.db and restart - it will recreate.

---

What's Next

You're on Milestone 2 now: BuddAI Knows Your Work

Next steps:

1. Test memory is working (sessions persist)
2. Have real conversations about your projects
3. Let BuddAI learn your preferences
4. Start building GilBot with BuddAI's help

Then: Add repository indexing (access to your 115 repos)

---

Current Limitations

What works:

• ✅ Persistent memory across sessions
• ✅ Conversation context maintenance
• ✅ Code generation
• ✅ Session management

What doesn't work yet:

• ❌ Access to your GitHub repos (Milestone 2)
• ❌ Pattern learning from your code (Milestone 3)
• ❌ Proactive suggestions (Milestone 4)
• ❌ Voice interface (Milestone 6)

But the foundation is SOLID.

---

File Structure

buddAI/
├── buddai.py           # Main script (run this)
├── README.md           # Full documentation
├── requirements.txt    # Dependencies (none yet!)
├── QUICKSTART.md       # This file
└── data/
    ├── conversations.db    # Auto-created
    └── session_*.json      # Exported sessions

---

First Real Task

Try building something with BuddAI right now:

James: I need a Python script that calculates the center of gravity for a robot chassis. 
Inputs: component weights and positions (x, y, z).
Output: CG coordinates.
Keep it modular and well-commented.

Let BuddAI generate it. Debug it. Feel the symbiosis starting.

---

Welcome to BuddAI v0.2 - Now with persistent memory!

The exocortex is awakening. 🧠✨