Skip to main content

Developer Guide

Welcome to the Radium Developer Guide. This guide helps you extend Radium's capabilities, understand its architecture, and contribute to the project.

Getting Started​

New to Radium development?

Architecture Documentation​

System Architecture​

Design Documents​

Architecture Decision Records (ADRs)​

Extending Radium​

Extension System​

MCP Integration​

Context Sources​

Development Guides​

Development Process​

Testing​

Guides​

Roadmap & Future Architecture​

Technical Roadmap​

  • Technical Architecture Roadmap - Technical implementation roadmap
    • Core Architecture Specification
    • Component Foundry Implementation
    • Global Component Graph Design
    • Agentic Component Integration
    • Performance & Scalability

Vision & Innovation​

  • Vision & Innovation - Long-term vision
    • Component Foundry Pattern (CFP)
    • Durable Autonomous Continuous Remediation (DACR)
    • Durable Recursive Component Generation (DRCG)
    • Autonomous Component-Centric Assembly (ACCA)

Protocol Specifications​

API Reference​

Codebase Structure​

Core Crates​

  • radium-core: Core backend with gRPC server and orchestration
  • radium-orchestrator: Agent orchestration engine
  • radium-models: Data models and types
  • radium-abstraction: Abstraction layers

Applications​

  • apps/cli: Command-line interface
  • apps/tui: Terminal user interface
  • apps/desktop: Tauri-based desktop application

Packages​

  • packages/api-client: TypeScript API client
  • packages/shared-types: Shared TypeScript types
  • packages/state: State management
  • packages/ui: UI components

Development Workflow​

Building​

# Build all crates
cargo build --workspace

# Build specific crate
cargo build -p radium-core

# Build with optimizations
cargo build --release

Testing​

# Run all tests
cargo test --workspace

# Run tests for specific crate
cargo test -p radium-core

# Run with coverage
cargo llvm-cov --workspace --html

Code Quality​

# Format code
cargo fmt --all

# Lint code
cargo clippy --workspace

# Check for issues
cargo check --workspace

Contributing​

Getting Started​

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests
  5. Submit a pull request

Code Standards​

  • Follow Rust style guidelines
  • Write comprehensive tests
  • Document public APIs
  • Update relevant documentation

Pull Request Process​

  1. Ensure all tests pass
  2. Update documentation
  3. Add changelog entry if needed
  4. Request review

Architecture Patterns​

Component Foundry Pattern​

Systematic approach to creating, validating, and composing reusable components.

Status: 📋 Planned Learn more: Roadmap: Component Foundry

Durable Autonomous Continuous Remediation (DACR)​

Self-healing systems that maintain component quality over time.

Status: 🔮 Future Learn more: Roadmap: DACR

Durable Recursive Component Generation (DRCG)​

Components that generate other components recursively.

Status: 🔮 Future Learn more: Roadmap: DRCG

Autonomous Component-Centric Assembly (ACCA)​

Systems that automatically assemble themselves from available components.

Status: 🔮 Future Learn more: Roadmap: ACCA

Resources​

Documentation​

External Resources​

Next Steps​

Ready to contribute? Start with Architecture Overview or Creating Extensions.