| Name | coda-code-assistant JSON |
| Version |
2025.7.12.441
JSON |
| download |
| home_page | None |
| Summary | A multi-provider, CLI-focused code assistant for AI-assisted development |
| upload_time | 2025-07-12 04:41:11 |
| 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**: Multi-provider AI integration
- **💬 Session**: Conversation persistence
- **🔍 Search**: Semantic code search
- **📊 Observability**: Logging and metrics
## 🚀 Quick Start
```bash
# Clone the repository
git clone 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
### 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
- 🌐 **Multi-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
- 🧪 **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/78/65/30fe57ba0ab347e6d21c0b6bcdc81a41272dd8c4e2600db4fc7e5ce091f3/coda_code_assistant-2025.7.12.441.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**: Multi-provider 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```bash\n# Clone the repository\ngit clone 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\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 **Multi-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- \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 multi-provider, CLI-focused code assistant for AI-assisted development",
"version": "2025.7.12.441",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "7b774168f147ad648ec4b74472acb07e0d7df787d8ef494c9f6b872f3549bf70",
"md5": "b5b8ec54254b56dafe72237e9b17db8e",
"sha256": "632c7cff41cb94328b8127e3b0a85d086512d294bdd8be8af90cfeec27a6ba5c"
},
"downloads": -1,
"filename": "coda_code_assistant-2025.7.12.441-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b5b8ec54254b56dafe72237e9b17db8e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 361665,
"upload_time": "2025-07-12T04:41:09",
"upload_time_iso_8601": "2025-07-12T04:41:09.364519Z",
"url": "https://files.pythonhosted.org/packages/7b/77/4168f147ad648ec4b74472acb07e0d7df787d8ef494c9f6b872f3549bf70/coda_code_assistant-2025.7.12.441-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "786530fe57ba0ab347e6d21c0b6bcdc81a41272dd8c4e2600db4fc7e5ce091f3",
"md5": "fdb37c98b6ca6817aba0f4bb5cf008fa",
"sha256": "dba247c6ab3f2e2c156e023fc1710efe5f8ddb573212e17fa06c439d4afac1be"
},
"downloads": -1,
"filename": "coda_code_assistant-2025.7.12.441.tar.gz",
"has_sig": false,
"md5_digest": "fdb37c98b6ca6817aba0f4bb5cf008fa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 1512439,
"upload_time": "2025-07-12T04:41:11",
"upload_time_iso_8601": "2025-07-12T04:41:11.178090Z",
"url": "https://files.pythonhosted.org/packages/78/65/30fe57ba0ab347e6d21c0b6bcdc81a41272dd8c4e2600db4fc7e5ce091f3/coda_code_assistant-2025.7.12.441.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-12 04:41:11",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "coda-code-assistant"
}
