termicode-ai 0.1.0

Groq-powered AI coding assistant with streaming responses, cost tracking, and zero-configuration setup

TermiCode AI Coding Assistant

A blazing fast, private, local AI coding assistant running directly in your terminal, powered by Groq and Llama 3.3.

---

TermiCode is a terminal-based Micro-SaaS AI coding assistant built for speed and security. It reads your codebase, modifies files securely via surgical edits, and can even run terminal commands (with your permission). Because it leverages Groq's lightning-fast inference API, TermiCode feels instant.

Bring Your Own Key (BYOK): No monthly subscriptions. No bloated Electron apps.

✨ Features

• ⚡ Blazing Fast: Powered by Groq's LPU technology and Meta's Llama models.
• 🛡️ Secure File Operations: Built-in path traversal protection and a blocklist for sensitive files (like .env).
• 👀 Surgical Edits: Modifies existing files precisely without rewriting the whole document, saving tokens and preventing hallucinations.
• 🖥️ Beautiful Terminal UI: Powered by rich for elegant panels, Markdown rendering, and live spinners.
• 🧠 Long-Term Memory: Automatically summarizes past context to preserve memory without exceeding token limits.
• 🚦 Command Execution: Can run test suites, git commands, and shell scripts on your behalf (always asks for permission first).

🚀 Installation

Option 1: Install globally via pipx (Recommended)

pipx installs Python CLI applications into isolated environments so they don't break your system Python.

pipx install termicode-ai

Option 2: Install via pip

pip install termicode-ai

⚙️ Configuration

TermiCode requires a free Groq API key to operate.

1. Get a free API key at console.groq.com/keys.
2. Create a .env file in the directory where you plan to run TermiCode, and add:

   GROQ_API_KEY=your_api_key_here
   

(Alternatively, you can export GROQ_API_KEY as a system environment variable in your terminal).

💻 Usage

Navigate to any project directory in your terminal and simply type:

termicode

This starts the interactive AI shell. Type /help to see available slash commands:

• /map - Print the current project structure tree.
• /clear - Clear the terminal screen.
• /reset - Wipe the agent's short-term memory and start fresh.
• /exit - Save session and exit.

Example Prompts:

• "Refactor my calculate_tax function in utils.py to handle edge cases."
• "Search the codebase for 'DATABASE_URL' and tell me where it's used."
• "Run the pytest suite and fix any failing tests."

🛠️ Developer Setup (Local Building)

If you want to contribute or build TermiCode locally from the source code:

1. Clone the repository

   git clone https://github.com/yourusername/termicode.git
   cd termicode
   

2. Create a virtual environment

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install in editable mode with dev dependencies

   pip install -e .[dev]
   

4. Run the CLI locally

   termicode
   

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.