Trans4mers

Trans4mers is an open-source native desktop operating environment built with Rust, Tauri v2, and SQLite for orchestrating multi-agent swarms locally using Ollama.

Key Architectural Foundations:

• Visual Swarm Designer: ReactFlow node-graph canvas to configure supervisor-worker, adversarial debate, and fan-out topologies.
• Hardware-Bounded Concurrency: Tokio semaphores manage execution permits so multiple background workers don't cause thermal throttling or memory exhaustion on consumer hardware.
• Event-Sourced SQLite WAL: Every domain event is written to an append-only log in an embedded SQLite database (trans4mers.sqlite) before state projections update tables, enabling state inspection and startup replay if interrupted.
• Human-in-the-Loop Diff Gate: High-risk actions (modifying files outside scratch, executing shell scripts) produce an LCS line-level diff with SHA-256 argument verification, pausing execution for operator review.
• 4-Tier Cognitive Memory: Combines working sliding context, episodic task history in SQLite, hybrid semantic search (LanceDB vectors + SQLite FTS5 BM25 fused with Reciprocal Rank Fusion), and procedural learned rules.
• Local-First Inference: Runs directly against local Ollama daemons, with optional BYOK support for frontier models (Anthropic, OpenAI, Google) stored in OS credential vaults.

Honest Reality & Alpha Disclosures: Trans4mers is an early-stage alpha project built solo by student developer Abhay Zangir. Because it's actively evolving and hasn't been tested across thousands of hardware setups, there will be unhandled edge cases, UI quirks, and bugs. While the capability system and diff reviewer exist in code, the application has not undergone third-party commercial security audits. Treat autonomous shell execution with caution and test in sandboxed or backed-up folders.