Ruixen v0.1.0 - The Curiosity Machine
🎯 Ruixen v0.1.0 - The Curiosity Machine
The collaborative AI agent you work WITH.
Transform simple questions into profound insights through thoughtful query refinement and synthesis.
Ruixen doesn't just answer - it awakens wonder.
✨ What's New
- 🤝 Collaborative Experience: Work WITH an AI agent, not command it - experience true intellectual
partnership - 🧠 Hybrid AI Architecture: Local model for private query orchestration + powerful cloud models for
synthesis - 🌸 Beautiful Zen Garden TUI: Minimalist keyboard-driven interface with Everforest theming
- 📝 Atomic Note System: Automatically saves insights as structured Markdown + YAML to ~/Documents/ruixen/
- 🦀 Constitutional Rust: Zero panics, graceful error handling, and modern async patterns
- 🔍 Query Refinement Engine: Transforms basic questions into thoughtful, multi-faceted explorations
- ⚡ Fast & Lightweight: 5MB native binary with no dependencies
🚀 Installation
Via Cargo (Recommended)
cargo install ruixen
ruixen
Direct Download
Download the ruixen binary below, make it executable, and add to your PATH:
chmod +x ruixen
sudo mv ruixen /usr/local/bin/
⚙️ Quick Setup
Ruixen requires both local and cloud AI to create the collaborative experience:
- Local AI (Required)
Install Ollama
brew install ollama # or visit ollama.ai
Pull a model
ollama pull llama3.2:3b
- Cloud AI (Required)
- Get a free API key from https://openrouter.ai
- Many free models available (no credit card needed for testing)
- First Launch
ruixen
Press 's' → Enter your OpenRouter API key → Select models → Start exploring!
🌟 Try Your First Query
Ask something that sparks genuine curiosity:
"Where do the stars go during the day?"
Watch Ruixen transform childhood wonder into scientific understanding while preserving the magic of
discovery.
🎨 Features
- Thoughtful Query Orchestration: Local AI refines your questions into profound explorations
- Seamless Cloud Synthesis: Powerful models create insightful, educational responses
- Knowledge Base Building: Every interaction becomes a searchable atomic note
- Privacy-First Design: Sensitive orchestration happens locally, only refined queries go to cloud
- Responsive Design: Works beautifully on any terminal size
- Rich Theming: Dark/light mode with carefully chosen color palettes
📖 Philosophy
"The curiosity machine doesn't just process queries - it awakens wonder."
Ruixen embodies a new paradigm for human-AI collaboration. Instead of the typical command-response
dynamic, it creates a thinking partnership where both human curiosity and AI capability combine to explore
ideas together.
🛠️ Built With
- Rust - For performance, safety, and reliability
- Ratatui - Beautiful terminal user interfaces
- Tokio - Async runtime for responsive interactions
- Constitutional Patterns - Every error handled gracefully
📚 Documentation
- Full Setup Guide: https://github.com/gitcoder89431/agentic#configuration
- Model Selection Guide: Learn how to choose the right AI models
- Troubleshooting: Common issues and solutions
🤝 Contributing
Built with love using constitutional Rust patterns. Issues and PRs welcome!