Omega
Omega is a personal agent that lives on your machine and keeps working with you across sessions. It maintains persistent conversations so you can pick up where you left off, a personal memory layer for durable facts about you and your work, and a knowledge base for documents, URLs, and code you want it to be able to search and reference later.
You choose the LLM provider. Omega keeps its database and local memory on your machine.
Install
Requirements:
- Python 3.11+
- Docker with Docker Compose running
- An API key for Openrouter, Anthropic, or an OpenAI-compatible provider
pip install omega-agent
omega setup
omega setup starts Omega's bundled database, prepares its schema, asks for your LLM provider settings, verifies the connection, and checks the local embedding model.
Start chatting
omega --help
That lists all the omega commands.
omega
That opens Omega's full-screen terminal interface.
Use the simpler scrolling chat instead:
omega --cli
Resume your most recent conversation:
omega --continue
Start a clean session:
omega new
Inside Omega TUI, type /commands to see the available chat commands. /quit exits.
What Omega keeps
Omega has three seperate kinds of context:
- Conversation history: your saved chat sessions.
- Personal memory: durable facts you directly share, such as preferences or ongoing work
- Knowledge base: URLs, notes, and code you deliberately add for later reference.
Add knowledge
omega ingest url "https://example.com/article"
omega ingest text "Notes I want Omega to search later"
omega ingest code --file ./main.py
Check queued or processed material:
omega kb list
omega kb status <item-id>
Check omega's installation
omega doctor
This checks the bundled database, pgvector, embedding model, provider configuration, and local memory directory.
Privacy
Omega stores its database and memory locally. Requests sent to an LLM go to the provider you configure. Those may include your chats, memory, knowledge base items. Your API key stays in your local configuration and is not in printed in Omega's normal output.
1 maintainer
Metadata
1 maintainer
Release files for omega-agent 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| omega_agent-0.1.0.tar.gz | 71.3 kB | Without provenance | Details for omega_agent-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| omega_agent-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for omega_agent-0.1.0-py3-none-any.whl |
Total release size: 160.2 kB
Release files / omega_agent-0.1.0.tar.gz
| Download URL | omega_agent-0.1.0.tar.gz |
|---|---|
| Size | 71.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dccf44922bf197793d9093277c29b616e7a11235fc5b1be89b61a1a6e9ca8ab8
|
|
BLAKE2b-256 checksum How to use checksums |
d2bf7d750b696d31c9058c8808367f1005760bc5c62072dade3608beecf8166f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"43","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / omega_agent-0.1.0-py3-none-any.whl
| Download URL | omega_agent-0.1.0-py3-none-any.whl |
|---|---|
| Size | 88.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5717c3f45cfbd9082169c63f12f6b2307f3032f433f6e61ee252364ddec6cc2c
|
|
BLAKE2b-256 checksum How to use checksums |
655711509563c05fa937b8a13acf89202d82ec0435b482759179da05a1c06197
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"43","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for omega-agent 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
