# TunaCode
<div align="center">
[](https://badge.fury.io/py/tunacode-cli)
[](https://pepy.tech/project/tunacode-cli)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
**AI-powered CLI coding assistant**
</div>
---
## Quick Install
```bash
# Option 1: One-line install (Linux/macOS)
wget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
# Option 2: pip install
pip install tunacode-cli
```
## Configuration
Choose your AI provider and set your API key:
```bash
# OpenAI
tunacode --model "openai:gpt-4o" --key "sk-your-openai-key"
# Anthropic Claude
tunacode --model "anthropic:claude-3.5-sonnet" --key "sk-ant-your-anthropic-key"
# OpenRouter (100+ models)
tunacode --model "openrouter:openai/gpt-4o" --key "sk-or-your-openrouter-key"
```
Your config is saved to `~/.config/tunacode.json` (edit directly with `nvim ~/.config/tunacode.json`)
### Recommended Models
Based on extensive testing, these models provide the best performance:
- `google/gemini-2.5-pro` - Excellent for complex reasoning
- `openai/gpt-4.1` - Strong general-purpose model
- `deepseek/deepseek-r1-0528` - Great for code generation
- `openai/gpt-4.1-mini` - Fast and cost-effective
- `anthropic/claude-4-sonnet-20250522` - Superior context handling
_Note: Formal evaluations coming soon. Any model can work, but these have shown the best results in practice._
## Start Coding
```bash
tunacode
```
## Basic Commands
| Command | Description |
| ------------------------ | ---------------------- |
| `/help` | Show all commands |
| `/model <provider:name>` | Switch model |
| `/clear` | Clear message history |
| `/compact` | Summarize conversation |
| `/branch <name>` | Create Git branch |
| `/yolo` | Skip confirmations |
| `!<command>` | Run shell command |
| `exit` | Exit TunaCode |
## Performance
TunaCode leverages parallel execution for read-only operations, achieving **3x faster** file operations:
Multiple file reads, directory listings, and searches execute concurrently using async I/O, making code exploration significantly faster.
## Features in Development
- **Streaming UI**: Currently working on implementing streaming responses for better user experience
- **Bug Fixes**: Actively addressing issues - please report any bugs you encounter!
_Note: While the tool is fully functional, we're focusing on stability and core features before optimizing for speed._
## Safety First
⚠️ **Important**: TunaCode can modify your codebase. Always:
- Use Git branches before making changes
- Review file modifications before confirming
- Keep backups of important work
## Documentation
- [**Features**](docs/FEATURES.md) - All features, tools, and commands
- [**Advanced Configuration**](docs/ADVANCED-CONFIG.md) - Provider setup, MCP, customization
- [**Architecture**](docs/ARCHITECTURE.md) - Source code organization and design
- [**Development**](docs/DEVELOPMENT.md) - Contributing and development setup
## Links
- [PyPI Package](https://pypi.org/project/tunacode-cli/)
- [GitHub Repository](https://github.com/alchemiststudiosDOTai/tunacode)
- [Report Issues](https://github.com/alchemiststudiosDOTai/tunacode/issues)
---
MIT License - see [LICENSE](LICENSE) file
Raw data
{
"_id": null,
"home_page": null,
"name": "tunacode-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "cli, agent, development, automation",
"author": null,
"author_email": "larock22 <noreply@github.com>",
"download_url": "https://files.pythonhosted.org/packages/70/5b/acbddd0c53883d4be135c97207a4e0a7daba5580eeb1ff6e3b618588f2e6/tunacode_cli-0.0.41.tar.gz",
"platform": null,
"description": "# TunaCode\n\n<div align=\"center\">\n\n[](https://badge.fury.io/py/tunacode-cli)\n[](https://pepy.tech/project/tunacode-cli)\n[](https://www.python.org/downloads/)\n[](https://opensource.org/licenses/MIT)\n\n**AI-powered CLI coding assistant**\n\n\n\n</div>\n\n---\n\n## Quick Install\n\n```bash\n# Option 1: One-line install (Linux/macOS)\nwget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash\n\n# Option 2: pip install\npip install tunacode-cli\n```\n\n## Configuration\n\nChoose your AI provider and set your API key:\n\n```bash\n# OpenAI\ntunacode --model \"openai:gpt-4o\" --key \"sk-your-openai-key\"\n\n# Anthropic Claude\ntunacode --model \"anthropic:claude-3.5-sonnet\" --key \"sk-ant-your-anthropic-key\"\n\n# OpenRouter (100+ models)\ntunacode --model \"openrouter:openai/gpt-4o\" --key \"sk-or-your-openrouter-key\"\n```\n\nYour config is saved to `~/.config/tunacode.json` (edit directly with `nvim ~/.config/tunacode.json`)\n\n### Recommended Models\n\nBased on extensive testing, these models provide the best performance:\n\n- `google/gemini-2.5-pro` - Excellent for complex reasoning\n- `openai/gpt-4.1` - Strong general-purpose model\n- `deepseek/deepseek-r1-0528` - Great for code generation\n- `openai/gpt-4.1-mini` - Fast and cost-effective\n- `anthropic/claude-4-sonnet-20250522` - Superior context handling\n\n_Note: Formal evaluations coming soon. Any model can work, but these have shown the best results in practice._\n\n## Start Coding\n\n```bash\ntunacode\n```\n\n## Basic Commands\n\n| Command | Description |\n| ------------------------ | ---------------------- |\n| `/help` | Show all commands |\n| `/model <provider:name>` | Switch model |\n| `/clear` | Clear message history |\n| `/compact` | Summarize conversation |\n| `/branch <name>` | Create Git branch |\n| `/yolo` | Skip confirmations |\n| `!<command>` | Run shell command |\n| `exit` | Exit TunaCode |\n\n## Performance\n\nTunaCode leverages parallel execution for read-only operations, achieving **3x faster** file operations:\n\n\n\nMultiple file reads, directory listings, and searches execute concurrently using async I/O, making code exploration significantly faster.\n\n## Features in Development\n\n- **Streaming UI**: Currently working on implementing streaming responses for better user experience\n- **Bug Fixes**: Actively addressing issues - please report any bugs you encounter!\n\n_Note: While the tool is fully functional, we're focusing on stability and core features before optimizing for speed._\n\n## Safety First\n\n\u26a0\ufe0f **Important**: TunaCode can modify your codebase. Always:\n\n- Use Git branches before making changes\n- Review file modifications before confirming\n- Keep backups of important work\n\n## Documentation\n\n- [**Features**](docs/FEATURES.md) - All features, tools, and commands\n- [**Advanced Configuration**](docs/ADVANCED-CONFIG.md) - Provider setup, MCP, customization\n- [**Architecture**](docs/ARCHITECTURE.md) - Source code organization and design\n- [**Development**](docs/DEVELOPMENT.md) - Contributing and development setup\n\n## Links\n\n- [PyPI Package](https://pypi.org/project/tunacode-cli/)\n- [GitHub Repository](https://github.com/alchemiststudiosDOTai/tunacode)\n- [Report Issues](https://github.com/alchemiststudiosDOTai/tunacode/issues)\n\n---\n\nMIT License - see [LICENSE](LICENSE) file\n",
"bugtrack_url": null,
"license": null,
"summary": "Your agentic CLI developer.",
"version": "0.0.41",
"project_urls": {
"Homepage": "https://github.com/larock22/tunacode",
"Repository": "https://github.com/larock22/tunacode"
},
"split_keywords": [
"cli",
" agent",
" development",
" automation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "31e90bd5b8b8f8b1e36fa3e23072fca9d4d7d2fdd1e3ccda0367fe96f37c9c1d",
"md5": "3a610f31aaa9128f2bb69dd85fab56ef",
"sha256": "15eab47df9522111e866ee0ccebe2718dc77543d9e2da20fd1cf4ebdca7a0456"
},
"downloads": -1,
"filename": "tunacode_cli-0.0.41-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3a610f31aaa9128f2bb69dd85fab56ef",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 136175,
"upload_time": "2025-07-17T20:38:59",
"upload_time_iso_8601": "2025-07-17T20:38:59.328513Z",
"url": "https://files.pythonhosted.org/packages/31/e9/0bd5b8b8f8b1e36fa3e23072fca9d4d7d2fdd1e3ccda0367fe96f37c9c1d/tunacode_cli-0.0.41-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "705bacbddd0c53883d4be135c97207a4e0a7daba5580eeb1ff6e3b618588f2e6",
"md5": "c6251253de9ab7fed0214f88de31f9f6",
"sha256": "dabc70928b7ba9273eeea1eda8ae661cbbafdac20d28f27b1f0325cff7f4fe53"
},
"downloads": -1,
"filename": "tunacode_cli-0.0.41.tar.gz",
"has_sig": false,
"md5_digest": "c6251253de9ab7fed0214f88de31f9f6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 234007,
"upload_time": "2025-07-17T20:39:00",
"upload_time_iso_8601": "2025-07-17T20:39:00.983264Z",
"url": "https://files.pythonhosted.org/packages/70/5b/acbddd0c53883d4be135c97207a4e0a7daba5580eeb1ff6e3b618588f2e6/tunacode_cli-0.0.41.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-17 20:39:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "larock22",
"github_project": "tunacode",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "typer",
"specs": [
[
"==",
"0.15.3"
]
]
},
{
"name": "pytest",
"specs": []
},
{
"name": "pytest-asyncio",
"specs": []
},
{
"name": "pydantic-ai",
"specs": [
[
"==",
"0.2.6"
]
]
}
],
"lcname": "tunacode-cli"
}
JSON
