agentome 0.1.0b1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- agentome-0.1.0b1/.github/workflows/publish.yml +46 -0
- agentome-0.1.0b1/.gitignore +8 -0
- agentome-0.1.0b1/LICENSE +13 -0
- agentome-0.1.0b1/PKG-INFO +94 -0
- agentome-0.1.0b1/README.md +71 -0
- agentome-0.1.0b1/agentome/__init__.py +78 -0
- agentome-0.1.0b1/pyproject.toml +36 -0
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
name: Publish to PyPI
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
release:
|
|
5
|
+
types: [published]
|
|
6
|
+
|
|
7
|
+
permissions:
|
|
8
|
+
id-token: write
|
|
9
|
+
|
|
10
|
+
jobs:
|
|
11
|
+
build:
|
|
12
|
+
runs-on: ubuntu-latest
|
|
13
|
+
steps:
|
|
14
|
+
- uses: actions/checkout@v4
|
|
15
|
+
|
|
16
|
+
- uses: actions/setup-python@v5
|
|
17
|
+
with:
|
|
18
|
+
python-version: "3.12"
|
|
19
|
+
|
|
20
|
+
- name: Install build tools
|
|
21
|
+
run: pip install build
|
|
22
|
+
|
|
23
|
+
- name: Build package
|
|
24
|
+
run: python -m build
|
|
25
|
+
|
|
26
|
+
- name: Upload artifact
|
|
27
|
+
uses: actions/upload-artifact@v4
|
|
28
|
+
with:
|
|
29
|
+
name: dist
|
|
30
|
+
path: dist/
|
|
31
|
+
|
|
32
|
+
publish:
|
|
33
|
+
needs: build
|
|
34
|
+
runs-on: ubuntu-latest
|
|
35
|
+
environment: pypi
|
|
36
|
+
permissions:
|
|
37
|
+
id-token: write
|
|
38
|
+
steps:
|
|
39
|
+
- name: Download artifact
|
|
40
|
+
uses: actions/download-artifact@v4
|
|
41
|
+
with:
|
|
42
|
+
name: dist
|
|
43
|
+
path: dist/
|
|
44
|
+
|
|
45
|
+
- name: Publish to PyPI
|
|
46
|
+
uses: pypa/gh-action-pypi-publish@release/v1
|
agentome-0.1.0b1/LICENSE
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
Copyright 2025-2026 Michael Bachaud (SwiftWing21)
|
|
2
|
+
|
|
3
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
|
+
you may not use this file except in compliance with the License.
|
|
5
|
+
You may obtain a copy of the License at
|
|
6
|
+
|
|
7
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
8
|
+
|
|
9
|
+
Unless required by applicable law or agreed to in writing, software
|
|
10
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
11
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
12
|
+
See the License for the specific language governing permissions and
|
|
13
|
+
limitations under the License.
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: agentome
|
|
3
|
+
Version: 0.1.0b1
|
|
4
|
+
Summary: Genome-based context compression for AI agents — thin wrapper around Helix Context
|
|
5
|
+
Project-URL: Homepage, https://github.com/SwiftWing21/agentome
|
|
6
|
+
Project-URL: Repository, https://github.com/SwiftWing21/agentome
|
|
7
|
+
Project-URL: Paper, https://mbachaud.substack.com/p/agentome
|
|
8
|
+
Project-URL: Helix Context, https://github.com/SwiftWing21/helix-context
|
|
9
|
+
Author-email: Michael Bachaud <swiftwing21@users.noreply.github.com>
|
|
10
|
+
License-Expression: Apache-2.0
|
|
11
|
+
License-File: LICENSE
|
|
12
|
+
Keywords: agentome,compression,context,genome,helix,llm,rag,ribosome
|
|
13
|
+
Classifier: Development Status :: 4 - Beta
|
|
14
|
+
Classifier: Intended Audience :: Developers
|
|
15
|
+
Classifier: License :: OSI Approved :: Apache Software License
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
19
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
20
|
+
Requires-Python: >=3.11
|
|
21
|
+
Requires-Dist: helix-context>=0.1.0b1
|
|
22
|
+
Description-Content-Type: text/markdown
|
|
23
|
+
|
|
24
|
+
# Agentome
|
|
25
|
+
|
|
26
|
+
**Genome-based context compression for AI agents.**
|
|
27
|
+
|
|
28
|
+
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.
|
|
29
|
+
|
|
30
|
+
This package is a thin wrapper around [Helix Context](https://github.com/SwiftWing21/helix-context), the reference implementation.
|
|
31
|
+
|
|
32
|
+
## Install
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
pip install agentome
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
This installs `helix-context` as a dependency and re-exports its entire public API.
|
|
39
|
+
|
|
40
|
+
## Quick Start
|
|
41
|
+
|
|
42
|
+
```python
|
|
43
|
+
from agentome import AgentomeManager, load_config
|
|
44
|
+
|
|
45
|
+
config = load_config()
|
|
46
|
+
manager = AgentomeManager(config)
|
|
47
|
+
|
|
48
|
+
# Ingest content into the genome
|
|
49
|
+
manager.ingest("Your codebase documentation here")
|
|
50
|
+
|
|
51
|
+
# Query compressed context (7x smaller than raw files)
|
|
52
|
+
window = manager.build_context("How does auth work?")
|
|
53
|
+
print(window.expressed_context)
|
|
54
|
+
print(window.context_health.status) # aligned | sparse | denatured
|
|
55
|
+
|
|
56
|
+
# Learn from exchanges (automatic replication)
|
|
57
|
+
manager.learn("How does auth work?", "JWT middleware validates tokens...")
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## What is an Agentome?
|
|
61
|
+
|
|
62
|
+
An **Agentome** is the complete set of compressed, structured knowledge that an AI agent carries as persistent memory. Like a biological genome:
|
|
63
|
+
|
|
64
|
+
- **Genes** store compressed knowledge units (code, docs, conversations)
|
|
65
|
+
- **Promoter tags** enable fast retrieval by topic
|
|
66
|
+
- **Chromatin state** controls accessibility (fresh vs stale)
|
|
67
|
+
- **Co-activation** builds associative memory over time
|
|
68
|
+
- **Replication** grows the genome from every conversation
|
|
69
|
+
|
|
70
|
+
The concept is described in the research paper: [The Agentome](https://mbachaud.substack.com/p/agentome)
|
|
71
|
+
|
|
72
|
+
## Agentome vs Helix Context
|
|
73
|
+
|
|
74
|
+
| | Agentome | Helix Context |
|
|
75
|
+
|---|---------|---------------|
|
|
76
|
+
| **What** | The concept/framework | The implementation |
|
|
77
|
+
| **Analogy** | "Genome" | "Human Genome Project" |
|
|
78
|
+
| **Package** | `pip install agentome` | `pip install helix-context` |
|
|
79
|
+
| **API** | Re-exports Helix Context | The actual engine |
|
|
80
|
+
|
|
81
|
+
## Full Documentation
|
|
82
|
+
|
|
83
|
+
See the [Helix Context README](https://github.com/SwiftWing21/helix-context) for complete documentation including:
|
|
84
|
+
|
|
85
|
+
- 6-step expression pipeline
|
|
86
|
+
- Delta-epsilon health monitoring
|
|
87
|
+
- Horizontal Gene Transfer (genome export/import)
|
|
88
|
+
- Claude Code skill integration
|
|
89
|
+
- Continue IDE integration
|
|
90
|
+
- ScoreRift divergence detection bridge
|
|
91
|
+
|
|
92
|
+
## License
|
|
93
|
+
|
|
94
|
+
Apache 2.0
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# Agentome
|
|
2
|
+
|
|
3
|
+
**Genome-based context compression for AI agents.**
|
|
4
|
+
|
|
5
|
+
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.
|
|
6
|
+
|
|
7
|
+
This package is a thin wrapper around [Helix Context](https://github.com/SwiftWing21/helix-context), the reference implementation.
|
|
8
|
+
|
|
9
|
+
## Install
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
pip install agentome
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
This installs `helix-context` as a dependency and re-exports its entire public API.
|
|
16
|
+
|
|
17
|
+
## Quick Start
|
|
18
|
+
|
|
19
|
+
```python
|
|
20
|
+
from agentome import AgentomeManager, load_config
|
|
21
|
+
|
|
22
|
+
config = load_config()
|
|
23
|
+
manager = AgentomeManager(config)
|
|
24
|
+
|
|
25
|
+
# Ingest content into the genome
|
|
26
|
+
manager.ingest("Your codebase documentation here")
|
|
27
|
+
|
|
28
|
+
# Query compressed context (7x smaller than raw files)
|
|
29
|
+
window = manager.build_context("How does auth work?")
|
|
30
|
+
print(window.expressed_context)
|
|
31
|
+
print(window.context_health.status) # aligned | sparse | denatured
|
|
32
|
+
|
|
33
|
+
# Learn from exchanges (automatic replication)
|
|
34
|
+
manager.learn("How does auth work?", "JWT middleware validates tokens...")
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## What is an Agentome?
|
|
38
|
+
|
|
39
|
+
An **Agentome** is the complete set of compressed, structured knowledge that an AI agent carries as persistent memory. Like a biological genome:
|
|
40
|
+
|
|
41
|
+
- **Genes** store compressed knowledge units (code, docs, conversations)
|
|
42
|
+
- **Promoter tags** enable fast retrieval by topic
|
|
43
|
+
- **Chromatin state** controls accessibility (fresh vs stale)
|
|
44
|
+
- **Co-activation** builds associative memory over time
|
|
45
|
+
- **Replication** grows the genome from every conversation
|
|
46
|
+
|
|
47
|
+
The concept is described in the research paper: [The Agentome](https://mbachaud.substack.com/p/agentome)
|
|
48
|
+
|
|
49
|
+
## Agentome vs Helix Context
|
|
50
|
+
|
|
51
|
+
| | Agentome | Helix Context |
|
|
52
|
+
|---|---------|---------------|
|
|
53
|
+
| **What** | The concept/framework | The implementation |
|
|
54
|
+
| **Analogy** | "Genome" | "Human Genome Project" |
|
|
55
|
+
| **Package** | `pip install agentome` | `pip install helix-context` |
|
|
56
|
+
| **API** | Re-exports Helix Context | The actual engine |
|
|
57
|
+
|
|
58
|
+
## Full Documentation
|
|
59
|
+
|
|
60
|
+
See the [Helix Context README](https://github.com/SwiftWing21/helix-context) for complete documentation including:
|
|
61
|
+
|
|
62
|
+
- 6-step expression pipeline
|
|
63
|
+
- Delta-epsilon health monitoring
|
|
64
|
+
- Horizontal Gene Transfer (genome export/import)
|
|
65
|
+
- Claude Code skill integration
|
|
66
|
+
- Continue IDE integration
|
|
67
|
+
- ScoreRift divergence detection bridge
|
|
68
|
+
|
|
69
|
+
## License
|
|
70
|
+
|
|
71
|
+
Apache 2.0
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Agentome — Genome-based context compression for AI agents.
|
|
3
|
+
|
|
4
|
+
This is the reference implementation, powered by Helix Context.
|
|
5
|
+
Agentome is the concept; Helix Context is the engine.
|
|
6
|
+
|
|
7
|
+
pip install agentome
|
|
8
|
+
|
|
9
|
+
is equivalent to:
|
|
10
|
+
|
|
11
|
+
pip install helix-context
|
|
12
|
+
|
|
13
|
+
All public APIs are re-exported from helix_context.
|
|
14
|
+
"""
|
|
15
|
+
|
|
16
|
+
from helix_context import (
|
|
17
|
+
# Config
|
|
18
|
+
HelixConfig,
|
|
19
|
+
load_config,
|
|
20
|
+
# Schemas
|
|
21
|
+
Gene,
|
|
22
|
+
ContextWindow,
|
|
23
|
+
ContextHealth,
|
|
24
|
+
ChromatinState,
|
|
25
|
+
PromoterTags,
|
|
26
|
+
EpigeneticMarkers,
|
|
27
|
+
# Core
|
|
28
|
+
Genome,
|
|
29
|
+
Ribosome,
|
|
30
|
+
OllamaBackend,
|
|
31
|
+
CodonChunker,
|
|
32
|
+
CodonEncoder,
|
|
33
|
+
RawStrand,
|
|
34
|
+
Codon,
|
|
35
|
+
HelixContextManager,
|
|
36
|
+
create_app,
|
|
37
|
+
# Exceptions
|
|
38
|
+
HelixError,
|
|
39
|
+
CodonAlignmentError,
|
|
40
|
+
PromoterMismatch,
|
|
41
|
+
FoldingError,
|
|
42
|
+
TranscriptionError,
|
|
43
|
+
GenomeFullError,
|
|
44
|
+
)
|
|
45
|
+
|
|
46
|
+
# Aliases for the Agentome vocabulary
|
|
47
|
+
AgentomeConfig = HelixConfig
|
|
48
|
+
AgentomeManager = HelixContextManager
|
|
49
|
+
|
|
50
|
+
__all__ = [
|
|
51
|
+
# Helix Context re-exports
|
|
52
|
+
"HelixConfig",
|
|
53
|
+
"load_config",
|
|
54
|
+
"Gene",
|
|
55
|
+
"ContextWindow",
|
|
56
|
+
"ContextHealth",
|
|
57
|
+
"ChromatinState",
|
|
58
|
+
"PromoterTags",
|
|
59
|
+
"EpigeneticMarkers",
|
|
60
|
+
"Genome",
|
|
61
|
+
"Ribosome",
|
|
62
|
+
"OllamaBackend",
|
|
63
|
+
"CodonChunker",
|
|
64
|
+
"CodonEncoder",
|
|
65
|
+
"RawStrand",
|
|
66
|
+
"Codon",
|
|
67
|
+
"HelixContextManager",
|
|
68
|
+
"create_app",
|
|
69
|
+
"HelixError",
|
|
70
|
+
"CodonAlignmentError",
|
|
71
|
+
"PromoterMismatch",
|
|
72
|
+
"FoldingError",
|
|
73
|
+
"TranscriptionError",
|
|
74
|
+
"GenomeFullError",
|
|
75
|
+
# Agentome aliases
|
|
76
|
+
"AgentomeConfig",
|
|
77
|
+
"AgentomeManager",
|
|
78
|
+
]
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["hatchling"]
|
|
3
|
+
build-backend = "hatchling.build"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "agentome"
|
|
7
|
+
version = "0.1.0b1"
|
|
8
|
+
description = "Genome-based context compression for AI agents — thin wrapper around Helix Context"
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.11"
|
|
11
|
+
license = "Apache-2.0"
|
|
12
|
+
authors = [
|
|
13
|
+
{ name = "Michael Bachaud", email = "swiftwing21@users.noreply.github.com" },
|
|
14
|
+
]
|
|
15
|
+
keywords = ["agentome", "llm", "context", "compression", "genome", "helix", "rag", "ribosome"]
|
|
16
|
+
classifiers = [
|
|
17
|
+
"Development Status :: 4 - Beta",
|
|
18
|
+
"Intended Audience :: Developers",
|
|
19
|
+
"License :: OSI Approved :: Apache Software License",
|
|
20
|
+
"Topic :: Scientific/Engineering :: Artificial Intelligence",
|
|
21
|
+
"Programming Language :: Python :: 3.11",
|
|
22
|
+
"Programming Language :: Python :: 3.12",
|
|
23
|
+
"Programming Language :: Python :: 3.13",
|
|
24
|
+
]
|
|
25
|
+
dependencies = [
|
|
26
|
+
"helix-context>=0.1.0b1",
|
|
27
|
+
]
|
|
28
|
+
|
|
29
|
+
[project.urls]
|
|
30
|
+
Homepage = "https://github.com/SwiftWing21/agentome"
|
|
31
|
+
Repository = "https://github.com/SwiftWing21/agentome"
|
|
32
|
+
Paper = "https://mbachaud.substack.com/p/agentome"
|
|
33
|
+
"Helix Context" = "https://github.com/SwiftWing21/helix-context"
|
|
34
|
+
|
|
35
|
+
[project.scripts]
|
|
36
|
+
agentome = "helix_context.server:main"
|