A high-performance, telemetrized process orchestrator and sandbox for Python and WASM, forged in Rust.

Documentation | Roadmap | Issues | Discussions

---

Overview

Welcome to the rustarium repository!

Why Use rustarium?

Coming soon!

Comparisons

Coming soon!

What's New

Welcome to the rustarium Launch!

This project has just been instantiated from the template repository. Keep an eye on this section for future release highlights, new features, and community announcements!

Quick Start

Coming soon!

Core Concepts

This project is built using modern Python tooling, enforcing strict code quality standards with Ruff and Mypy, and providing a robust Pydantic-driven settings architecture for configuration resolution.

Component Architecture

The repository is structured to separate documentation, application logic, and testing cleanly:

• src/rustarium/: The primary application source code.
• tests/: Comprehensive test suite ensuring reliability, organized into unit/, integration/, and e2e/.
• docs/: Source code for the MkDocs Material documentation site, including step-by-step guides, references, and getting started tutorials.
• examples/: Runnable reference projects demonstrating real-world configurations.
• .github/workflows/: Advanced CI/CD pipelines governing the project lifecycle, built around reusable workflow templates.

Advanced Usage

Please check the examples/ directory for advanced examples and configurations.

General

Contributing

We welcome contributions! Please see our Contributing Guide for more details. For development setup, check out DEVELOPING.md. Please ensure you follow our Code of Conduct in all interactions.

Support and Security

• For help and general questions, see SUPPORT.md.
• To report a security vulnerability, please refer to our Security Policy.

AI & LLM Tooling

This repository includes first-class support for agentic and LLM-assisted development workflows:

• AGENTS.md: Repository-specific instructions for AI coding agents (Codex, Copilot Workspace, Gemini, Claude, Cursor, and similar tools). Contains the authoritative guide for project structure, executable commands, code style, and critical constraints.
• llms.txt: A machine-readable index of the project's documentation, following the llms.txt specification. Served at /llms.txt on the documentation site to help LLMs quickly locate and consume relevant content.

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

Citations

If you use this repository or the resulting software in your research, please cite it using the following BibTeX entry:

@software{rustarium,
  author = {markurtz},
  title = {rustarium},
  year = 2026,
  url = {https://github.com/markurtz/rustarium}
}