User Guide
Welcome to the Radium User Guide. This comprehensive guide covers everything you need to know to effectively use Radium for building and managing AI agent systems.
Getting Started
New to Radium? Start here:
- Quick Start - Get up and running in minutes
- Core Concepts - Understand fundamental concepts
- Installation - Installation instructions
Core Features
Agent Configuration
Configure and manage AI agents for your specific needs.
- Agent Configuration Guide - Complete guide to configuring agents
- TOML configuration format
- Model selection and parameters
- Prompt management
- Persona system integration
- Self-hosted model configuration
Orchestration
Intelligent task routing that automatically selects and coordinates agents.
- Orchestration Guide - Natural language interaction with agents
- Orchestration Configuration - Configure orchestration behavior
- Orchestration Testing - Test and validate orchestration
- Orchestration Troubleshooting - Solve common issues
Persona System
Intelligent model selection with cost optimization and automatic fallback.
- Persona System - Model selection and cost optimization
- Performance profiles
- Fallback chains
- Cost optimization strategies
Memory & Context
Maintain continuity across sessions and provide context to agents.
- Memory & Context System - Plan-scoped memory and context management
- Context Sources - File, HTTP, Jira, and BrainGrid sources
Learning System
Track mistakes, preferences, and successes to build pattern recognition.
- Learning System - Learn from experience
- Mistake tracking
- Preference learning
- ACE Skillbook
Vibe Check
Metacognitive oversight to prevent reasoning lock-in and improve agent alignment.
- Vibe Check - Chain-Pattern Interrupt system
- Risk assessment
- Pattern detection
- Phase-aware feedback
Constitution Rules
Session-scoped rules for workflow constraints.
- Constitution Rules - Temporary rules for specific sessions
Custom Commands
Reusable command definitions with template substitution.
- Custom Commands - Create and use custom commands
Guides
Step-by-step guides for common tasks:
- Agent Creation Guide - Create custom agents
- Reasoning Configuration - Configure reasoning models
- Sandbox Setup - Set up sandboxed execution
- Optimizing Costs - Reduce API costs
- Extension Best Practices - Best practices for extensions
- Extension Distribution - Share extensions
- Extension Versioning - Version management
- Extension Testing - Test extensions
- Adding New Engine Provider - Add custom AI providers
Feature Documentation
Planning & Execution
- Autonomous Planning - AI-powered plan generation
- Plan Execution - Execute structured plans
- DAG Dependencies - Dependency management
Security & Policies
- Policy Engine - Fine-grained tool execution control
- Constitution System - Session-based rules
- Security Features - Security configuration and best practices
Advanced Features
- Workflow Behaviors - Dynamic execution control
- Checkpointing - Save and resume workflows
- Thinking Mode - Deep reasoning support
- Context Files - Persistent agent instructions
- Context Caching - Performance optimization
- Session Analytics - Track costs and performance
- Sandboxing - Safe execution environment
Integration Guides
Extensions
- Extension System - Package and share components
- Extension Quickstart - Get started with extensions
- Creating Extensions - Build your own extensions
- Extension Marketplace - Discover and share extensions
MCP Integration
- MCP User Guide - Model Context Protocol integration
- MCP Configuration - Configure MCP servers
- MCP Tools - Available MCP tools
Self-Hosted Models
- Self-Hosted Models - Run local AI models
- Ollama Setup - Set up Ollama
- vLLM Setup - Set up vLLM
- LocalAI Setup - Set up LocalAI
CLI Reference
- CLI Documentation - Complete CLI reference
- CLI Commands - All available commands
- CLI Configuration - Configure CLI behavior
Roadmap & Vision
- Roadmap - Open-source roadmap and vision
- Vision & Innovation - Long-term vision and innovations
- Technical Architecture - Technical roadmap
Best Practices
Agent Design
- Use clear, specific prompts
- Define agent roles and responsibilities
- Configure appropriate models for tasks
- Use persona system for cost optimization
Orchestration
- Write natural, descriptive requests
- Let orchestrator select agents automatically
- Use multi-agent workflows for complex tasks
Memory & Context
- Leverage plan-scoped memory
- Use context sources for external information
- Build on previous agent outputs
Security
- Configure policies for tool execution
- Use approval modes appropriately
- Set up session constitutions for sensitive tasks
Troubleshooting
Common issues and solutions:
- Agent not found: Check agent discovery and configuration
- Orchestration not working: Verify API keys and configuration
- Memory issues: Check memory storage and retrieval
- Performance problems: Review session analytics and optimize
For detailed troubleshooting, see:
Next Steps
- Developer Guide - Extend Radium's capabilities
- API Reference - Complete API documentation
- Examples - Example workflows and configurations
Ready to build? Start with Agent Configuration or explore Orchestration for intelligent task routing.