| Name | coda-code-assistant JSON |
| Version |
2025.8.13.2318
JSON |
| download |
| home_page | None |
| Summary | A CLI-focused code assistant for AI-assisted development |
| upload_time | 2025-08-13 23:19:01 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<div align="center">
<img src="assets/logos/coda-terminal-logo.svg" alt="Coda Terminal Logo" width="400" height="280">
# Coda - AI Code Assistant
A powerful, modular AI code assistant that brings the best of AI-powered development directly to your terminal.
</div>
---
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://github.com/psf/black)
## ✨ What is Coda?
Coda is your AI pair programmer that lives in your terminal, built with a modular architecture that supports multiple AI providers including Oracle OCI GenAI, OpenAI, Anthropic, Google, and 100+ more via LiteLLM.
## 🏗️ Modular Architecture
Coda is built with a clean, three-layer architecture:
```
┌─────────────────────────────────────────────────┐
│ Apps Layer │
│ (CLI, Web UI, Plugins, Custom) │
├─────────────────────────────────────────────────┤
│ Services Layer │
│ (Integration, Orchestration, Workflows) │
├─────────────────────────────────────────────────┤
│ Base Layer │
│ (Config, Theme, Providers, Session, Search, etc) │
└─────────────────────────────────────────────────┘
```
### Base Modules
- **🔧 Config**: Unified configuration management
- **🎨 Theme**: Terminal UI and formatting
- **🤖 Providers**: AI integration
- **💬 Session**: Conversation persistence
- **🔍 Search**: Semantic code search
- **📊 Observability**: Logging and metrics
## 🚀 Quick Start
### Try without installing
```bash
# Run directly with uvx (no installation needed!)
uvx --from coda-code-assistant coda
```
### Install from PyPI
```bash
# Install with pip
pip install coda-code-assistant
# Or install with uv
uv pip install coda-code-assistant
# Run Coda
coda
```
### Install from source
```bash
# Clone the repository with submodules
git clone --recursive https://github.com/djvolz/coda-code-assistant.git
cd coda-code-assistant
# Install with uv (recommended)
uv sync
# Run Coda
uv run coda
```
### Using Individual Modules
```python
from coda.base.config import Config
from coda.base.providers import ProviderFactory
# Initialize configuration
config = Config()
# Create a provider
factory = ProviderFactory(config.to_dict())
provider = factory.create("openai")
# Start chatting
response = provider.chat(
messages=[{"role": "user", "content": "Hello!"}],
model="gpt-4"
)
print(response["content"])
```
## 📖 Documentation
### In-Repository Docs
- [Integration Guide](docs/integration-guide.md) - How to use modules together
- [Module Documentation](coda/base/) - Individual module READMEs
- [Example Applications](tests/examples/) - Working examples
- [Diagram Rendering Guide](docs/guides/diagram-rendering.md) - How to create diagrams
### Wiki Documentation
For comprehensive documentation, visit our **[Wiki](https://github.com/djvolz/coda-code-assistant/wiki)**:
- **[Getting Started Guide](https://github.com/djvolz/coda-code-assistant/wiki/Getting-Started)** - Installation and setup
- **[AI Modes](https://github.com/djvolz/coda-code-assistant/wiki/AI-Modes)** - Specialized AI personalities
- **[Development Guide](https://github.com/djvolz/coda-code-assistant/wiki/Development-Guide)** - Contributing and development workflow
- **[Architecture Guide](https://github.com/djvolz/coda-code-assistant/wiki/Architecture)** - Deep dive into the modular design
- **[Troubleshooting](https://github.com/djvolz/coda-code-assistant/wiki/Troubleshooting)** - Common issues and solutions
## 🎯 Key Features
- 🌐 **Provider Support**: Works with Oracle OCI GenAI, Ollama, OpenAI, Anthropic, Google, and 100+ providers
- 🧩 **Modular Design**: Use only the components you need
- 💻 **Terminal-First**: Designed for developers who live in the command line
- 🧠 **Smart AI Modes**: Specialized modes for coding, debugging, explaining, and reviewing
- 💾 **Session Management**: Save, resume, and branch conversations
- 🎨 **Beautiful Interface**: Rich terminal UI with syntax highlighting
- 🔧 **Tool Integration**: File operations, web search, and more via MCP
- 📊 **Diagram Rendering**: Create flowcharts, UML diagrams, and graphs with [diagram-renderer](https://github.com/djvolz/diagram-renderer)
- 🧪 **Well-Tested**: Comprehensive test suite ensures reliability
## 🛠️ Example Applications
Check out our [example applications](tests/examples/) to see Coda modules in action:
- **[Simple Chatbot](tests/examples/simple_chatbot/)** - Basic provider usage
- **[Session Manager](tests/examples/session_manager/)** - Persistent conversations
- **[Code Analyzer](tests/examples/code_analyzer/)** - AI-powered code analysis
## 🤝 Contributing
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
### Development
```bash
# Install development dependencies
uv sync --dev
# Run tests
uv run pytest
# Run type checks
uv run mypy coda
# Format code
uv run black .
uv run ruff check --fix
```
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🔗 Links
- [Full Documentation](https://github.com/djvolz/coda-code-assistant/wiki)
- [Issue Tracker](https://github.com/djvolz/coda-code-assistant/issues)
- [Discussions](https://github.com/djvolz/coda-code-assistant/discussions)
- [Roadmap](https://github.com/djvolz/coda-code-assistant/blob/main/ROADMAP.md)
- [Architecture Documentation](docs/architecture/)
---
<p align="center">Made with ❤️ by the Coda community</p>
Raw data
{
"_id": null,
"home_page": null,
"name": "coda-code-assistant",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/34/49/3d5347c280529a4f17bf37b8cc3b6a3bfa24ed5b9ffe288bf7b18141ac88/coda_code_assistant-2025.8.13.2318.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <img src=\"assets/logos/coda-terminal-logo.svg\" alt=\"Coda Terminal Logo\" width=\"400\" height=\"280\">\n \n # Coda - AI Code Assistant\n \n A powerful, modular AI code assistant that brings the best of AI-powered development directly to your terminal.\n</div>\n\n---\n\n[](https://opensource.org/licenses/MIT)\n[](https://www.python.org/downloads/)\n[](https://github.com/psf/black)\n\n## \u2728 What is Coda?\n\nCoda is your AI pair programmer that lives in your terminal, built with a modular architecture that supports multiple AI providers including Oracle OCI GenAI, OpenAI, Anthropic, Google, and 100+ more via LiteLLM.\n\n## \ud83c\udfd7\ufe0f Modular Architecture\n\nCoda is built with a clean, three-layer architecture:\n\n```\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Apps Layer \u2502\n\u2502 (CLI, Web UI, Plugins, Custom) \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 Services Layer \u2502\n\u2502 (Integration, Orchestration, Workflows) \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 Base Layer \u2502\n\u2502 (Config, Theme, Providers, Session, Search, etc) \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n### Base Modules\n\n- **\ud83d\udd27 Config**: Unified configuration management\n- **\ud83c\udfa8 Theme**: Terminal UI and formatting\n- **\ud83e\udd16 Providers**: AI integration\n- **\ud83d\udcac Session**: Conversation persistence\n- **\ud83d\udd0d Search**: Semantic code search\n- **\ud83d\udcca Observability**: Logging and metrics\n\n## \ud83d\ude80 Quick Start\n\n### Try without installing\n\n```bash\n# Run directly with uvx (no installation needed!)\nuvx --from coda-code-assistant coda\n```\n\n### Install from PyPI\n\n```bash\n# Install with pip\npip install coda-code-assistant\n\n# Or install with uv\nuv pip install coda-code-assistant\n\n# Run Coda\ncoda\n```\n\n### Install from source\n\n```bash\n# Clone the repository with submodules\ngit clone --recursive https://github.com/djvolz/coda-code-assistant.git\ncd coda-code-assistant\n\n# Install with uv (recommended)\nuv sync\n\n# Run Coda\nuv run coda\n```\n\n### Using Individual Modules\n\n```python\nfrom coda.base.config import Config\nfrom coda.base.providers import ProviderFactory\n\n# Initialize configuration\nconfig = Config()\n\n# Create a provider\nfactory = ProviderFactory(config.to_dict())\nprovider = factory.create(\"openai\")\n\n# Start chatting\nresponse = provider.chat(\n messages=[{\"role\": \"user\", \"content\": \"Hello!\"}],\n model=\"gpt-4\"\n)\nprint(response[\"content\"])\n```\n\n## \ud83d\udcd6 Documentation\n\n### In-Repository Docs\n- [Integration Guide](docs/integration-guide.md) - How to use modules together\n- [Module Documentation](coda/base/) - Individual module READMEs\n- [Example Applications](tests/examples/) - Working examples\n- [Diagram Rendering Guide](docs/guides/diagram-rendering.md) - How to create diagrams\n\n### Wiki Documentation\nFor comprehensive documentation, visit our **[Wiki](https://github.com/djvolz/coda-code-assistant/wiki)**:\n\n- **[Getting Started Guide](https://github.com/djvolz/coda-code-assistant/wiki/Getting-Started)** - Installation and setup\n- **[AI Modes](https://github.com/djvolz/coda-code-assistant/wiki/AI-Modes)** - Specialized AI personalities\n- **[Development Guide](https://github.com/djvolz/coda-code-assistant/wiki/Development-Guide)** - Contributing and development workflow\n- **[Architecture Guide](https://github.com/djvolz/coda-code-assistant/wiki/Architecture)** - Deep dive into the modular design\n- **[Troubleshooting](https://github.com/djvolz/coda-code-assistant/wiki/Troubleshooting)** - Common issues and solutions\n\n## \ud83c\udfaf Key Features\n\n- \ud83c\udf10 **Provider Support**: Works with Oracle OCI GenAI, Ollama, OpenAI, Anthropic, Google, and 100+ providers\n- \ud83e\udde9 **Modular Design**: Use only the components you need\n- \ud83d\udcbb **Terminal-First**: Designed for developers who live in the command line\n- \ud83e\udde0 **Smart AI Modes**: Specialized modes for coding, debugging, explaining, and reviewing\n- \ud83d\udcbe **Session Management**: Save, resume, and branch conversations\n- \ud83c\udfa8 **Beautiful Interface**: Rich terminal UI with syntax highlighting\n- \ud83d\udd27 **Tool Integration**: File operations, web search, and more via MCP\n- \ud83d\udcca **Diagram Rendering**: Create flowcharts, UML diagrams, and graphs with [diagram-renderer](https://github.com/djvolz/diagram-renderer)\n- \ud83e\uddea **Well-Tested**: Comprehensive test suite ensures reliability\n\n## \ud83d\udee0\ufe0f Example Applications\n\nCheck out our [example applications](tests/examples/) to see Coda modules in action:\n\n- **[Simple Chatbot](tests/examples/simple_chatbot/)** - Basic provider usage\n- **[Session Manager](tests/examples/session_manager/)** - Persistent conversations\n- **[Code Analyzer](tests/examples/code_analyzer/)** - AI-powered code analysis\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Development\n\n```bash\n# Install development dependencies\nuv sync --dev\n\n# Run tests\nuv run pytest\n\n# Run type checks\nuv run mypy coda\n\n# Format code\nuv run black .\nuv run ruff check --fix\n```\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83d\udd17 Links\n\n- [Full Documentation](https://github.com/djvolz/coda-code-assistant/wiki)\n- [Issue Tracker](https://github.com/djvolz/coda-code-assistant/issues)\n- [Discussions](https://github.com/djvolz/coda-code-assistant/discussions)\n- [Roadmap](https://github.com/djvolz/coda-code-assistant/blob/main/ROADMAP.md)\n- [Architecture Documentation](docs/architecture/)\n\n---\n\n<p align=\"center\">Made with \u2764\ufe0f by the Coda community</p>",
"bugtrack_url": null,
"license": null,
"summary": "A CLI-focused code assistant for AI-assisted development",
"version": "2025.8.13.2318",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d8f5cffe25967d6bbde45becf5f8dc2887e14a82c52778b7526f5b168d0d9fd4",
"md5": "c05549bb7f8dd5d66d8ef2d6ed4147e5",
"sha256": "706e16ca8fbb6ed82bdef7293abe198b8beec6697fa649e3a329272f50c97748"
},
"downloads": -1,
"filename": "coda_code_assistant-2025.8.13.2318-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c05549bb7f8dd5d66d8ef2d6ed4147e5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 397306,
"upload_time": "2025-08-13T23:19:00",
"upload_time_iso_8601": "2025-08-13T23:19:00.082105Z",
"url": "https://files.pythonhosted.org/packages/d8/f5/cffe25967d6bbde45becf5f8dc2887e14a82c52778b7526f5b168d0d9fd4/coda_code_assistant-2025.8.13.2318-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "34493d5347c280529a4f17bf37b8cc3b6a3bfa24ed5b9ffe288bf7b18141ac88",
"md5": "774208a796a6705a2a87426c474f61d2",
"sha256": "373425611b0c487254f3524a74c2412b2adedf90493d9cc2c3d534f705fc8b9f"
},
"downloads": -1,
"filename": "coda_code_assistant-2025.8.13.2318.tar.gz",
"has_sig": false,
"md5_digest": "774208a796a6705a2a87426c474f61d2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 1553752,
"upload_time": "2025-08-13T23:19:01",
"upload_time_iso_8601": "2025-08-13T23:19:01.581258Z",
"url": "https://files.pythonhosted.org/packages/34/49/3d5347c280529a4f17bf37b8cc3b6a3bfa24ed5b9ffe288bf7b18141ac88/coda_code_assistant-2025.8.13.2318.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-13 23:19:01",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "coda-code-assistant"
}
