Skip to main content

​
Installation

OmniCoreAgent needs Python 3.12, 3.13 or 3.14. Check with python --version before you install. On Python 3.10 or 3.11 the install stops with a message saying so; releases before 0.4.3 instead installed an old version that cannot build an agent (see An older version was installed below).

​
Prerequisites

Before installing OmniCoreAgent, ensure you have the following:
System Requirements:
  • Python 3.12–3.14 (development and CI use Python 3.12)
  • LLM API key from any supported provider (OpenAI, Anthropic, Google, etc.)
  • UV package manager (recommended) or pip

​
Check Python Version

UV is faster than pip and handles dependencies more reliably:

​
Installation Methods

​
Optional Production Extras

The base install is the runtime with its harness. Add heavier production integrations only when your agent uses them:
With UV:

​
Verify Installation

After installation, check the version you got:
These docs describe 0.5.0 and later; Upgrading lists what changed since 0.4. If the command is not found, pip show omnicoreagent names the version you have; for 0.3.x, see An older version was installed below.

​
Troubleshooting

OmniCoreAgent 0.4.0 and later need Python 3.12 or later. Until the guard release (0.3.10, published with 0.4.3), pip on Python 3.10 or 3.11 did not fail: it quietly installed 0.3.9, the last release that supported 3.11 — which cannot even build an agent (its package was published without one of its own modules, so OmniCoreAgent(...) raises ModuleNotFoundError: No module named 'omnicoreagent.core.workspace').Check which Python you are installing into, and use 3.12 or later:
A venv uv venv makes has no pip of its own, so a plain pip install there reaches the system’s pip; use uv pip, or uv venv --seed.
Error: Permission denied during installationSolution: Use user installation:
Error: ImportError: Redis memory requires optional dependency 'redis'. Install it with: pip install 'omnicoreagent[redis]'Solution: Install the extra the message names:
Every extra is in the table above; all installs every one but harbor.
If you encounter issues:
  1. Search existing issues
  2. Create a new issue with:
    • Your operating system
    • Python version
    • Installation method used
    • Complete error message

​
Next Steps

Quick Start

Your first agent, a tool, and the evidence of its run, in five minutes

Core Concepts

Learn about memory, events, and tools

Configuration

Environment variables and agent settings