Bluna AI is an intelligent, local terminal-based coding assistant powered by the Qwen2.5-coder:0.5b model through Ollama.
Perfect for beginners and seasoned developers who want a private, customizable AI mentor to guide them, help them practice, and build consistent coding habits with intelligent web search capabilities.
- 💻 Multi-Language Support – Works with Julia, Python, C/C++, Rust, Go, PHP, SQL, Web Development, and many others.
- 🧠 Intelligent AI Tutor – Powered by Qwen2.5-coder:0.5b with specialized coding instruction capabilities.
- 🌐 Smart Web Search – When current information is needed, automatically searches DuckDuckGo for up-to-date answers with source attribution.
- 🧩 Memory System – Remembers your preferences, learning style, and previous conversations for personalized assistance.
- 📅 Learning Scheduler – Creates customized study schedules and learning plans.
- 🪶 Completely Private & Lightweight – Runs 100% offline using Ollama (zero data leaves your machine).
- 🧰 Beautiful TUI – Intuitive, Carbon-Blue themed terminal interface for a smooth experience.
- ⚙️ Cross-Platform – Fully compatible with Windows, macOS, and Linux.
- v2 Analyst Release: Advanced AI assistant with web scraping, memory management, and scheduler features
- v1 Coder Companion: Streamlined coding companion focused on direct programming assistance
Linux/macOS:
./setupWindows:
setup.batLinux/macOS:
cd v1_coder_companion
./setupWindows:
cd v1_coder_companion
setup.bat- Operating System: Windows 10+, macOS 10.14+, or Linux (Ubuntu 18.04+, CentOS 7+, or equivalent)
- RAM: 4GB minimum, 8GB recommended
- Storage: 2GB free space
- Internet: Required for initial setup and AI model downloads
- Julia (1.9+): Programming language runtime
- Ollama: Local AI model runner
- Required Julia Packages: HTTP, JSON, Crayons, FIGlet, Cascadia, Gumbo, etc.
- Git: Version control system
- curl/wget: Download utilities
- Build tools: For package compilation
- Download or clone the Bluna AI repository
- Open terminal in the project directory
- Run the setup script:
chmod +x setup ./setup
- Follow the prompts to complete installation
- Download or clone the Bluna AI repository
- Open Command Prompt or PowerShell as Administrator
- Navigate to the project directory
- Run the setup script:
setup.bat
- Follow the prompts to complete installation
# Linux/macOS
./setup /path/to/custom/installation
# Windows
setup.bat "C:\path\to\custom\installation"- Download and install Ollama for your operating system.
- Pull the Qwen2.5-coder model:
ollama pull qwen2.5-coder:0.5b- Clone the repository:
git clone https://github.com/am3lue/bluna-ai.git
cd bluna-ai/v2_analyst_release- Launch Bluna AI:
julia --project=. main.jlsudo apt update
sudo apt install julia curl wget gitbrew install julia gitchoco install julia git-
Launch Bluna AI:
# v2 Analyst Release julia ~/.bluna-ai/main.jl # v1 Coder Companion julia ~/.bluna-ai/v1_coder_companion/main.jl
-
Complete the interactive setup wizard
-
Choose your preferences:
- Programming language to learn
- Teaching style (Friendly, Socratic, Concise)
- Learning genre (General Basics, Data Structures, etc.)
- Linux: Desktop shortcut created automatically
- macOS: Application bundle created in ~/Applications
- Windows: Batch file shortcut created on Desktop
The installation process will attempt to download a recommended Ollama model:
- v2 Analyst Release:
qwen2.5-coder:0.5b - v1 Coder Companion:
phi3
If automatic download fails, you can manually install models:
ollama pull qwen2.5-coder:0.5b # For v2
ollama pull phi3 # For v1After installation:
~/.bluna-ai/
├── main.jl # v2 main application
├── config.json # User configuration
├── bluna_memory.json # AI memory storage
├── v1_coder_companion/ # v1 application
│ ├── main.jl
│ └── setup.jl
├── images/ # Application icons
└── *.md # Generated learning plans
Julia not found after installation:
# Add Julia to PATH (Linux/macOS)
echo 'export PATH="$PATH:/opt/julia/bin"' >> ~/.bashrc
source ~/.bashrc
# Windows: Restart command prompt or add to PATH manuallyPermission denied errors:
# Linux/macOS: Make scripts executable
chmod +x setupOllama connection issues:
# Start Ollama service
ollama serve
# Check if running
curl http://localhost:11434Package installation failures:
# Manual Julia package installation
julia -e 'using Pkg; Pkg.add("HTTP")'If automatic installation fails, install manually:
- Visit Julia Downloads
- Download for your operating system
- Install following platform-specific instructions
- Visit Ollama Downloads
- Download and install for your platform
- Start the service:
ollama serve
User > What is recursion?
Bluna > Recursion is when a function calls itself to solve a problem...
User > What is the latest Python version?
Bluna > 🔍 Let me search for the latest Python version...
Bluna > Based on my search, Python 3.12 is the latest stable version...
Sources:
- https://www.python.org/downloads/
User > Remember that I prefer learning with examples
Bluna > Got it! I'll remember you prefer examples in my explanations.
User > Create schedule
Bluna > I'll create a personalized learning schedule for you...
- Memory Management: "Remember that I prefer Python over JavaScript"
- Learning Schedules: "Create a schedule for learning Rust on weekends"
- Web Research: Ask questions that require current information
- Interactive Teaching: Multiple teaching styles available
- Direct Code Help: Ask specific programming questions
- Quick Solutions: Get immediate coding assistance
- Streamlined Interface: Focus on coding productivity
v1_coder_companion/- Original v1 implementation with classic interfacev2_analyst_release/- Current version with enhanced AI capabilities and web search
- Enhanced AI Integration - Qwen2.5-coder:0.5b model for better coding assistance
- Web Search Capabilities - Intelligent DuckDuckGo integration for current information
- Memory System - Persistent user preferences and conversation history
- Learning Scheduler - Personalized study plan generation
A huge thank you to the talented team that made Bluna AI possible:
- am3lue (Francis Masanja) – Lead Developer
- emmatiko (Emmanuel Matiko) – Project Manager
- Minza (Minza Blue) – Debugging & Quality Assurance
- ayryn (Ireen Sebastian) – AI Specialist
Their passion and expertise turned this idea into a powerful, friendly learning companion.
- Check the troubleshooting section above
- Verify all dependencies are installed correctly
- Ensure Ollama is running:
ollama serve - Check Julia is accessible:
julia --version
- Check console output for detailed error messages
- Installation logs are displayed in real-time
- AI interactions are stored in
bluna_memory.json
# Remove installation directory
rm -rf ~/.bluna-ai
# Remove desktop shortcuts
rm ~/Desktop/Bluna-AI.desktop # Linux
rm ~/Desktop/Bluna-AI.bat # Windows- Complete Setup: Run the interactive wizard on first launch
- Explore Features: Try different commands and teaching styles
- Create Learning Plans: Use the scheduler for structured learning
- Customize: Modify
config.jsonfor personalized experience
- Multi-Engine Search - Add Bing/Google backup for web searches
- Improved Error Handling - Better timeout and connection management
- Enhanced Source Filtering - Better search result quality
- Interactive Quizzes - Skill assessment and practice modes
- Progress Visualization - Better tracking and achievement systems
- Extended Language Support - More programming languages
- Web Interface - Full GUI with rich interactions
- Code Execution - Live code running and testing
- Advanced Analytics - Deep learning insights and recommendations
Contributions are welcome! Please read CONTRIBUTING.md for guidelines.
- Contribute Code - Pick an item from the roadmap and start coding
- Bug Reports - Help us identify and fix issues
- Feature Ideas - Share your suggestions for new capabilities
- Feedback - Tell us what works well and what could be better
- Testing - Try out new features and report your experience
- Documentation - Help improve guides and examples
- UI/UX Improvements - Make Bluna even more beautiful and user-friendly
- Visual Learning Aids - Create diagrams and illustrations for complex concepts
This project is open source. See LICENSE file for details.
Imagine Bluna AI as your personal coding mentor who:
- Knows You - Remembers your learning style, preferences, and progress
- Stays Current - Always has the latest information about programming languages and tools
- Makes Learning Fun - Uses interactive methods, games, and visual aids
- Grows With You - Adapts to your increasing skill level and changing interests
- Connects Communities - Links learners with mentors, study groups, and resources
Enjoy learning with Bluna AI! 🌙💙
For the latest updates and documentation, visit our GitHub repository. We'd love to see you there! 🚀