⚡ PyCode

🖥️ AI-powered coding assistant in your terminal

Chat with LLMs, run tools, and write code — all without leaving your command line.

🚀 Lightweight • 🎨 Beautiful • 🔧 Powerful • 🆓 Free

📥 Download & Project

🌐 Website: pycode.kozow.com

📦 Binary available on the website

✨ Features

🧠 Core

Feature	Description
🔀 Build / Plan / Chat Modes	Full access, read-only, or web search only — switch with `Ctrl+B`. Chat mode uses only web tools for conversational queries.
💬 Chat Sessions	Persistent conversations with history. Revisit, rename, or delete anytime.
📦 Context Compaction	Auto-summarizes when context fills. Preserves decisions, file changes, and tasks.
🎨 Theme Picker	Multiple built-in themes, switchable at runtime (`Ctrl+P`).
🤖 Model Picker	Fetch and switch models on the fly (`Ctrl+O`). Auto-detects free models.

🛠️ Tools

Tool	Description
📝 `bash`	Execute shell commands
📄 `read`	Read file contents
✏️ `write`	Write/create files
🔍 `edit`	Edit files with exact string replacement
📁 `glob`	Find files by glob pattern
🔎 `grep`	Search file contents with regex
🩹 `apply_patch`	Apply aider-style patches
🌐 `webfetch`	Fetch and extract text from a URL
🔍 `websearch`	Search the web for current information
✅ `todowrite`	Create and manage a structured task list
❓ `question`	Ask the user a multiple-choice question
🤖 `task`	Spawn sub-agents for delegated research
🏷️ `set_title`	Set session title (auto-generated)

🎯 UI & Experience

Feature	Description
🎨 Beautiful TUI	Powered by Textual. Rich colors, themes, responsive.
📊 Context Usage Bar	Real-time token usage and percentage in the status bar.
🧠 Reasoning Display	Shows model "thinking" process with elapsed time.
📊 Diff Rendering	Colored diffs for `apply_patch` results.
🕘 Persistent Input History	Your previous prompts are saved to disk and recalled in any new session with `↑/↓`.
⚙️ Settings Modal	Configure API endpoint, key, and model (`Ctrl+S`).
❓ Help Screen	Keyboard shortcuts reference (`F1`).
📋 Copy Messages	Copy assistant responses to clipboard (`Ctrl+Y`).
🛡️ Error Dialogs	Friendly handling for rate limits, auth failures, server errors.

🔧 Advanced

Feature	Description
🌐 Web Browser Mode	Run `pycode web` to serve the TUI in your browser via textual-serve.
💻 CLI Subcommands	`pycode` (TUI), `pycode web` (browser), `pycode run TEXT` (one-shot), `pycode help` (version + usage).
🔍 Auto Update Check	`pycode help` checks for newer versions and shows an update notice.
🔄 Models.dev Integration	Auto-fetches real context windows from models.dev catalog.
🌐 Proxy Support	Respects `HTTPS_PROXY` / `HTTP_PROXY` / `ALL_PROXY` (upper or lower case) and honors `NO_PROXY` — applied only to the LLM API.
📬 Message Queue	Type while the model is processing — messages are queued automatically.
⚡ Non-blocking Tools	All tools execute in background threads. UI stays responsive.
📁 File References	Reference files with `@path` — PyCode reads them on demand.
🖥️ Shell Integration	Run shell commands inline with `!command` or `/shell command`.

🚀 Quick Start

📦 Install (Linux x86_64)

curl -L https://pycode.kozow.com/bin/pycode -o pycode && chmod +x ./pycode

▶️ Run

./pycode           # 🖥️  Start the TUI
./pycode web       # 🌐  Serve in browser
./pycode help      # ℹ️  Show version and usage
./pycode run TEXT  # 🚀  One-shot prompt

⌨️ Keyboard Shortcuts

Shortcut	Action
`Ctrl+C`	Quit
`Ctrl+N`	New session
`Ctrl+L`	Clear chat
`Ctrl+R`	Session picker
`Ctrl+B`	Cycle mode: build/plan/chat
`Ctrl+S`	Settings dialog
`Ctrl+P`	Theme picker
`Ctrl+O`	Model picker
`Ctrl+Y`	Copy message to clipboard
`F1`	Help screen
`Escape`	Stop generation / abort
`PageUp/PageDown`	Scroll chat
`@` (in input)	File picker
`!command` (in input)	Run shell command
`↑/↓` (in input)	Recall input history (persistent across sessions)

🤖 Models

Free Models (No API key needed)

PyCode works out of the box with OpenCode Zen and auto-detects all the free models available on the endpoint (Ctrl+O to pick). The default is mimo-v2.5-free. Real context windows are pulled from the models.dev catalog.

Model	Description
🧠 `mimo-v2.5-free`	Balanced performance (default)
⚡ `deepseek-v4-flash-free`	Fast and efficient
🔍 `ling-3.0-flash-free`	Fast language model
💡 `nemotron-3-ultra-free`	Advanced capabilities
🚀 `north-mini-code-free`	Optimized for code
🌊 `laguna-s-2.1-free`	Lightweight and fast
🌐 Exa	Web search — also free

Bring Your Own API

PyCode works with any OpenAI-compatible API. Configure via Ctrl+S or edit ~/.config/pycode-tui/config.json:

OpenAI — set API URL to https://api.openai.com/v1
Anthropic — via LiteLLM proxy
Ollama — set API URL to http://localhost:11434/v1
OpenCode Zen — default, free models included

📊 System Requirements

Requirement	Details
🖥️ OS	Linux (x86_64)
💾 RAM	< 50 MB
📦 Binary	~25 MB (x86_64)
📜 License	Proprietary

⚙️ Configuration

Path	Description
`~/.config/pycode-tui/config.json`	API URL, API key, model, theme
`~/.config/pycode-tui/sessions/`	Session history (JSON)
`~/.config/pycode-tui/models-dev.json`	Model catalog cache (7-day TTL)
`~/.config/pycode-tui/prompt-history.jsonl`	Input history (persistent across sessions)

Environment Variables

Variable	Description
`HTTPS_PROXY` / `https_proxy`	Proxy for HTTPS requests (LLM API only)
`HTTP_PROXY` / `http_proxy`	Proxy for HTTP requests (LLM API only)
`ALL_PROXY` / `all_proxy`	Fallback proxy for any scheme (LLM API only)
`NO_PROXY` / `no_proxy`	Hosts excluded from the proxy
`SSL_CERT_FILE`	Custom CA certificate bundle
`TEXTUAL_DRIVER`	Textual driver override

📜 License

PyCode is a closed-source, proprietary application. It is distributed as a ready-to-run binary and is free to use, but the source code is not published and may not be redistributed or modified.

🙏 Credits

Inspired by OpenCode — an AI-powered coding assistant for the terminal.

📞 Contact

Channel	Link
🌐 Website	pycode.kozow.com
📧 Email	[email protected]
💬 WhatsApp	@hellocodelinux

Made with ❤️ for terminal lovers