Genome-based context compression for AI agents — thin wrapper around Helix Context
Project description
Agentome
Genome-based context compression for AI agents.
Agentome is a framework for treating AI agent context like a biological genome — compressing, storing, and selectively expressing knowledge instead of stuffing raw text into context windows.
This package is a thin wrapper around Helix Context, the reference implementation.
Install
pip install agentome
This installs helix-context as a dependency and re-exports its entire public API.
Quick Start
from agentome import AgentomeManager, load_config
config = load_config()
manager = AgentomeManager(config)
# Ingest content into the genome
manager.ingest("Your codebase documentation here")
# Query compressed context (7x smaller than raw files)
window = manager.build_context("How does auth work?")
print(window.expressed_context)
print(window.context_health.status) # aligned | sparse | denatured
# Learn from exchanges (automatic replication)
manager.learn("How does auth work?", "JWT middleware validates tokens...")
What is an Agentome?
An Agentome is the complete set of compressed, structured knowledge that an AI agent carries as persistent memory. Like a biological genome:
- Genes store compressed knowledge units (code, docs, conversations)
- Promoter tags enable fast retrieval by topic
- Chromatin state controls accessibility (fresh vs stale)
- Co-activation builds associative memory over time
- Replication grows the genome from every conversation
The concept is described in the research paper: The Agentome
Agentome vs Helix Context
| Agentome | Helix Context | |
|---|---|---|
| What | The concept/framework | The implementation |
| Analogy | "Genome" | "Human Genome Project" |
| Package | pip install agentome |
pip install helix-context |
| API | Re-exports Helix Context | The actual engine |
Full Documentation
See the Helix Context README for complete documentation including:
- 6-step expression pipeline
- Delta-epsilon health monitoring
- Horizontal Gene Transfer (genome export/import)
- Claude Code skill integration
- Continue IDE integration
- ScoreRift divergence detection bridge
License
Apache 2.0
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agentome-0.1.0b1.tar.gz.
File metadata
- Download URL: agentome-0.1.0b1.tar.gz
- Upload date:
- Size: 3.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1f6be31593001888960a425c2028e12d90d3bdfcbb6487ab16ff96c0784a45b1
|
|
| MD5 |
ca04694ce7ad06fce56be3e17bbbbd9c
|
|
| BLAKE2b-256 |
2f8f3913fecb0f304d6d5c8481bdfcd75ee015104caac0c4d946fa03adb7e1d8
|
Provenance
The following attestation bundles were made for agentome-0.1.0b1.tar.gz:
Publisher:
publish.yml on SwiftWing21/agentome
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
agentome-0.1.0b1.tar.gz -
Subject digest:
1f6be31593001888960a425c2028e12d90d3bdfcbb6487ab16ff96c0784a45b1 - Sigstore transparency entry: 1258569209
- Sigstore integration time:
-
Permalink:
SwiftWing21/agentome@0452551b732b9aa1b5217e1e8609b37e4c3de193 -
Branch / Tag:
refs/tags/v0.1.0b1 - Owner: https://github.com/SwiftWing21
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@0452551b732b9aa1b5217e1e8609b37e4c3de193 -
Trigger Event:
release
-
Statement type:
File details
Details for the file agentome-0.1.0b1-py3-none-any.whl.
File metadata
- Download URL: agentome-0.1.0b1-py3-none-any.whl
- Upload date:
- Size: 3.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4756b48377098027fa3d81018b5ccfef78ba3aaa231b77150e7fad5f910dd77f
|
|
| MD5 |
b69b1a06de27348baba0826fe49a3c10
|
|
| BLAKE2b-256 |
34c60cc6878c17ae2d71568079222f5d889c30c202db1d3c5a05b0b75aaa93c0
|
Provenance
The following attestation bundles were made for agentome-0.1.0b1-py3-none-any.whl:
Publisher:
publish.yml on SwiftWing21/agentome
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
agentome-0.1.0b1-py3-none-any.whl -
Subject digest:
4756b48377098027fa3d81018b5ccfef78ba3aaa231b77150e7fad5f910dd77f - Sigstore transparency entry: 1258569240
- Sigstore integration time:
-
Permalink:
SwiftWing21/agentome@0452551b732b9aa1b5217e1e8609b37e4c3de193 -
Branch / Tag:
refs/tags/v0.1.0b1 - Owner: https://github.com/SwiftWing21
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@0452551b732b9aa1b5217e1e8609b37e4c3de193 -
Trigger Event:
release
-
Statement type: