Atom Zero 49.2M — a local assistant that cites its sources
Atom Zero is a local, source-cited assistant built around a 49.2M parameter model trained from scratch. Facts live in a local RAG index, not in the model weights; the model handles wording and behavior while deterministic tools, documents, memory and citations do the rest.
This is the standalone atomzero package. The low-VRAM trainer remains in the
separate streamft package.
Install
pip install atomzero
Optional local MiniLM reranker:
pip install "atomzero[neural]"
The model weights are not bundled. Download them from Hugging Face or ModelScope.
Run
atomzero `
--model checkpoints/transformer_behavior_50m_scaled `
--tokenizer data/chat_en_bpe8k.json `
--docs data/docs.db
Then open the local page (default http://127.0.0.1:8013).
Features
- PDF, DOCX, HTML and Markdown ingestion with page/section citations.
- Evidence API/panel that opens the exact local chunks behind a citation.
- Deterministic tools: time, safe arithmetic, tasks, name/likes memory.
- Constrained plan API (
/v1/agent/plan): allowlist, three-step cap and explicit confirmation for task/research side effects. - Sessions: transcript restore, export/import, exact Forget.
- Research queue: approved-only Wikipedia fetch and local teacher notes.
- Optional local provider: Ollama/OpenAI-compatible free-form chat while RAG, tools and memory stay local.
- No telemetry and no hosted service.
Honest limits
- The raw 49.2M model scores 2/10 on the no-RAG knowledge probe.
- The product scores 21/21 on the narrow authored product benchmark because RAG and tools do the work.
- The core context is 128 tokens; it is not a general reasoning or coding model.
- No OCR; scanned PDFs need OCR before ingestion.
- Safety is optional and off by default.
Links
- Full project map: https://github.com/byjameson/stream-finetune/blob/main/docs/PROJECT_OVERVIEW.md
- Documents/citations: https://github.com/byjameson/stream-finetune/blob/main/docs/DOCUMENTS.md
- Tool plans: https://github.com/byjameson/stream-finetune/blob/main/docs/TOOL_PLANNING.md
- Benchmarks: https://github.com/byjameson/stream-finetune/blob/main/docs/BENCHMARKS.md
- Model card: https://huggingface.co/byjameson/atom-zero-49m
- Contact: gokhancava@gmail.com
Apache-2.0 for code and weights; data attribution in NOTICE.
Metadata
Release files for atomzero 0.1.1
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 |
|---|---|---|---|---|
| atomzero-0.1.1.tar.gz | 91.2 kB | Without provenance | Details for atomzero-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| atomzero-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for atomzero-0.1.1-py3-none-any.whl |
Total release size: 187.6 kB
Release files / atomzero-0.1.1.tar.gz
| Download URL | atomzero-0.1.1.tar.gz |
|---|---|
| Size | 91.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e455b605254752a3650708e107a2b1e82ed1d8cf457f59c72bd7d066987dba29
|
|
BLAKE2b-256 checksum How to use checksums |
ecad64431452101db53912270885cfc8259bda03ae98d34c1302497c334d39e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.9
|
Release files / atomzero-0.1.1-py3-none-any.whl
| Download URL | atomzero-0.1.1-py3-none-any.whl |
|---|---|
| Size | 96.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ce27a9a10ee60f2efbbd902896e4ea395e2307cb57d98125951ef162bbda1969
|
|
BLAKE2b-256 checksum How to use checksums |
1cc1f8289860508c3e521826c692b48e7c04827a2e6fbc89c66a9e6d87783ac0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.9
|
Security for atomzero 0.1.1
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.