Installation
Prerequisites
Before installing OmniCoreAgent, ensure you have the following:System Requirements:
- Python 3.10+ (Python 3.11+ recommended)
- LLM API key from any supported provider (OpenAI, Anthropic, Google, etc.)
- UV package manager (recommended) or pip
Check Python Version
Install UV (Recommended)
UV is faster than pip and handles dependencies more reliably:- macOS/Linux
- Windows
- Python pip
Installation Methods
- UV (Recommended)
- pip
- From Source
Optional Production Extras
The base install stays focused on the core agent harness. Add heavier production integrations only when your agent uses them:Verify Installation
After installation, verify that you can import the package:Troubleshooting
Python Version Error
Python Version Error
Error:
OmniCoreAgent requires Python 3.10+Solution: Upgrade your Python version:Permission Denied
Permission Denied
Error: Permission denied during installationSolution: Use user installation:
Missing Optional Backend
Missing Optional Backend
Error: Use
ImportError: Redis memory requires optional dependency 'redis'Solution: Install the matching extra:postgres, mongodb, s3, serve, tokenizer, otel, langsmith, opik, or all for other optional integrations.Getting Help
Getting Help
If you encounter issues:
- Search existing issues
- Create a new issue with:
- Your operating system
- Python version
- Installation method used
- Complete error message
Next Steps
Quick Start
Build your first agent in under 30 seconds
Core Concepts
Learn about memory, events, and tools
Configuration
Environment variables and agent settings