Ask anything — git commands, Linux tips, Docker, coding help — and get instant answers with interactive chat or quick one-shot queries. Beautiful markdown tables and conversation memory included.
Interactive chat sessions with conversation memory. Ask follow-up questions naturally — the AI remembers context.
Beautiful table rendering powered by Rich library. Automatically sanitizes and formats markdown tables.
One-shot for quick questions. REPL for interactive conversations. Choose what fits your workflow.
Responses appear character by character, just like ChatGPT — making it feel alive.
Headers in yellow, commands in green, bullets in cyan. Easy to scan at a glance.
Animated spinner with random messages so you know it's working while the API responds.
No ugly tracebacks. Timeout, connection errors, and API failures show friendly messages.
Works with OpenRouter, Groq, Together AI, or OpenAI. Switch providers easily in config.
Free tiers available on OpenRouter, Groq, and Together AI. No credit card required.
Rename the shortcut to anything — ai, ask, helper — and use that as your command.
git clone https://github.com/shyam0880/AI-Terminal-Assistant-BuddyAI.git cd AI-Terminal-Assistant-BuddyAI
pip install -r requirements.txt
Rename config.example.py to config.py and add your API key:
OPENROUTER_API_KEY = "your-api-key-here" MODEL = "openrouter/auto"
Edit buddy.bat with the full path to buddy.py:
@echo off python C:\your\path\to\buddy.py %*
buddy.bat to anything — ai.bat, ask.bat, helper.bat. That name becomes your terminal command.
Follow these steps to run buddy from any directory:
Step 1: Search "Environment Variables" in Windows Start menu Step 2: Click "Edit the system environment variables" Step 3: Under System Variables → find Path → click Edit Step 4: Click New → enter your folder path (e.g., C:\ai\) Step 5: Click OK on all windows and restart your terminal
REPL Mode (Interactive chat with conversation memory):
buddy Type 'exit', 'quit', or press Ctrl+C to quit you: how do I create a git branch [AI explains git branch creation] you: what about switching to it? [AI explains with context from previous question]
One-Shot Mode (Quick questions):
buddy how to check open ports on windows buddy explain git rebase vs merge buddy what is a docker volume ask what is async await ← if you renamed it to ask
Core language
AI model access
Terminal colors
Markdown rendering
HTTP API calls
Loading animation