8Dionysus/ATM10-Agent

Local-first ATM10 companion for Windows 11: vision, RAG/KAG memory, dry-run automation, voice, and a gateway-backed operator panel.

1

stars

221

commits

Python

primary language

Sep 5, 2026

updated

all-the-mods-10
atm10
automation
fastapi
kag
local-ai
minecraft
openvino
rag
streamlit
voice
windows
Browse cluster: Python Web Scraping & Automation

README

ATM10-Agent

Windows package Portable Core Linux Security Nightly

Autonomous local-first companion for All the Mods 10. Windows 11 + PowerShell 7 is the first product edge; the deterministic core is portable.

The product is one installable modular monolith:

Perception -> Interpretation -> World/Memory -> Response/Plan -> optional Action/Voice -> Trace

atm10_agent owns the composition root and the atm10 doctor|run|replay|eval|consolidate-memory|windows-acceptance|verify-windows-acceptance CLI. Core install, deterministic turn, replay, and product eval need no model, service, sibling repository, .aoa, OS skill profile, shared validator, or network access.

Start here

  • current capabilities and honest limits: MANIFEST.md
  • direction and definition of done: ROADMAP.md
  • active commands: docs/RUNBOOK.md
  • autonomy law and dependency dispositions: docs/autonomy/README.md
  • controlled donor intake and provenance: docs/intake/README.md
  • Windows acceptance boundary: docs/WINDOWS_PRODUCT_EDGE_BOUNDARY.md
  • bounded hybrid degradation receipts: docs/ANTIFRAGILITY_FIRST_WAVE.md
  • public document roles: docs/SOURCE_OF_TRUTH.md
  • durable rationale: docs/decisions/README.md

Current posture

  • deterministic full-loop turns and replay are package-owned;
  • file-backed retrieval and product KAG return citations without external stores;
  • action is fenced to deterministic dry-run output with intent/trace correlation;
  • optional voice degrades explicitly when no provider is configured;
  • Windows capture is package-owned, DXcam-first for monitor/region capture, and records Pillow fallback failures;
  • live Windows acceptance has a package-owned v2 receipt collector with explicit degraded no-audio posture and an offline artifact verifier, while the current physical run remains a separate release gate;
  • append-only run traces, mutable state, and eval reports use separate directories;
  • online memory capture keeps observed world state and player episodes append-only, working context mutable, and consolidation explicit;
  • file world/KAG returns authored-source handles, derived relation context, and bounded readiness without treating memory as world authority;
  • every deterministic turn records selected providers, failed attempts, fallback reasons, return handles, and rejected/unavailable/degraded posture without a global router;
  • provider benchmarks can create review candidates, but activation, post-activation verification, and rollback remain separate explicit records;
  • eval reports keep bounded claims, categorical verdicts, provenance, blind spots, portability, and measurement-only metrics explicit;
  • the legacy gateway/operator/pilot/service control plane is retired.

The useful M6.19 intent vocabulary remains protected through the package: open_quest_book, check_inventory_tool, and open_world_map. All three produce plans and dry-run evidence; none emits keyboard or mouse input.

The portable Linux autonomy gate is green, so bounded one-way donor intake is open through docs/intake/donor-ledger.json. Live Windows acceptance remains unfinished in a separate lane and is not claimed by that gate.

  • CONTRIBUTING.md
  • SECURITY.md
  • CODE_OF_CONDUCT.md
  • LICENSE

Contributors

8Dionysus

221 commits

8Dionysus/ATM10-Agent

Local-first ATM10 companion for Windows 11: vision, RAG/KAG memory, dry-run automation, voice, and a gateway-backed operator panel.

1

stars

221

commits

Python

primary language

Sep 5, 2026

updated

all-the-mods-10
atm10
automation
fastapi
kag
local-ai
minecraft
openvino
rag
streamlit
voice
windows
Browse cluster: Python Web Scraping & Automation

README

ATM10-Agent

Windows package Portable Core Linux Security Nightly

Autonomous local-first companion for All the Mods 10. Windows 11 + PowerShell 7 is the first product edge; the deterministic core is portable.

The product is one installable modular monolith:

Perception -> Interpretation -> World/Memory -> Response/Plan -> optional Action/Voice -> Trace

atm10_agent owns the composition root and the atm10 doctor|run|replay|eval|consolidate-memory|windows-acceptance|verify-windows-acceptance CLI. Core install, deterministic turn, replay, and product eval need no model, service, sibling repository, .aoa, OS skill profile, shared validator, or network access.

Start here

  • current capabilities and honest limits: MANIFEST.md
  • direction and definition of done: ROADMAP.md
  • active commands: docs/RUNBOOK.md
  • autonomy law and dependency dispositions: docs/autonomy/README.md
  • controlled donor intake and provenance: docs/intake/README.md
  • Windows acceptance boundary: docs/WINDOWS_PRODUCT_EDGE_BOUNDARY.md
  • bounded hybrid degradation receipts: docs/ANTIFRAGILITY_FIRST_WAVE.md
  • public document roles: docs/SOURCE_OF_TRUTH.md
  • durable rationale: docs/decisions/README.md

Current posture

  • deterministic full-loop turns and replay are package-owned;
  • file-backed retrieval and product KAG return citations without external stores;
  • action is fenced to deterministic dry-run output with intent/trace correlation;
  • optional voice degrades explicitly when no provider is configured;
  • Windows capture is package-owned, DXcam-first for monitor/region capture, and records Pillow fallback failures;
  • live Windows acceptance has a package-owned v2 receipt collector with explicit degraded no-audio posture and an offline artifact verifier, while the current physical run remains a separate release gate;
  • append-only run traces, mutable state, and eval reports use separate directories;
  • online memory capture keeps observed world state and player episodes append-only, working context mutable, and consolidation explicit;
  • file world/KAG returns authored-source handles, derived relation context, and bounded readiness without treating memory as world authority;
  • every deterministic turn records selected providers, failed attempts, fallback reasons, return handles, and rejected/unavailable/degraded posture without a global router;
  • provider benchmarks can create review candidates, but activation, post-activation verification, and rollback remain separate explicit records;
  • eval reports keep bounded claims, categorical verdicts, provenance, blind spots, portability, and measurement-only metrics explicit;
  • the legacy gateway/operator/pilot/service control plane is retired.

The useful M6.19 intent vocabulary remains protected through the package: open_quest_book, check_inventory_tool, and open_world_map. All three produce plans and dry-run evidence; none emits keyboard or mouse input.

The portable Linux autonomy gate is green, so bounded one-way donor intake is open through docs/intake/donor-ledger.json. Live Windows acceptance remains unfinished in a separate lane and is not claimed by that gate.

  • CONTRIBUTING.md
  • SECURITY.md
  • CODE_OF_CONDUCT.md
  • LICENSE

Contributors

8Dionysus

221 commits

Languages

Python

99.8%