Skip to main content

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.

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)

Source distribution for atomzero 0.1.1
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)

Table of built distributions (wheels) for atomzero 0.1.1
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page