Tardis OS 🎻

"All of time and space; everything that ever happened or ever will - where do you want to start?"

Tardis OS is an experimental Operating System designed with Artificial Intelligence at its core. Unlike traditional OSs where AI is an application layer, Tardis embeds Large Language Models (LLMs) and Vector Databases deep into the system services, enabling semantic understanding of data, temporal queries, and natural language interaction.

📚 Documentation

• Official Documentation: Architecture, ADRs, and guides.
• API Docs: Generated Rust documentation.

🚀 The Stack

Tardis is built as a Rust workspace containing several specialized crates:

✨ Features

Tardis uses feature flags to enable experimental capabilities:

• nova: Enables experimental modules ("Nova" features) such as:
  • Biographer: Narrative generation from history.
  • Sonic Screwdriver: System diagnosis and repair tools.
  • Curiosity: Active learning engine.
  • TUI Dashboard: Rich terminal interface.

Enable it by running:

cargo run --features nova --bin tardis

🛠️ Getting Started

Prerequisites

• Rust: Stable (1.85+) for userspace, Nightly for kernel.
• Tools: qemu-system-x86_64 (for kernel testing).

Build & Run

1. Build Userspace Components:

   cargo build
   

2. Run the AI Shell:

   cargo run --bin tardis
   

3. Run Tests:

   cargo test
   

4. Build Documentation:

   cargo doc --open
   

🤝 Contributing

We welcome contributions!

For Developers & AI Agents: Please read CLAUDE.md first. It contains critical information about the workspace structure, coding standards, and the "worktree workflow" we use.

1. Fork the repo.
2. Create your feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes.
4. Push to the branch.
5. Open a Pull Request.

📜 License

MIT OR Apache-2.0