KuttAI is a beautiful, modern command-line interface AI chatbot designed specifically for KTU students. With its stunning gradient-colored interface and powerful AI capabilities, KuttAI provides intelligent assistance for studies, exams, and all things related to the KTU ecosystem.
| Feature | Description |
|---|---|
| 🎨 Beautiful UI | Gradient-colored interface with modern design |
| ⚡ Real-time Responses | Fast AI-powered answers to academic questions |
| 📚 KTU-Focused | Specialized knowledge for KTU curriculum |
| 🔒 Privacy First | All data stored locally on your machine |
| 🎯 Smart Context | Understands context from previous conversations |
| 📊 System Integration | Displays relevant system information |
| ⚡ GPU Optimization | Automatically detects GPU and uses it for faster model inference |
npx kuttai# Clone the repository
git clone https://github.com/cyberkutti-iedc/kuttai.git
# Navigate to the project directory
cd kuttai
# Install dependencies
npm install
# Download the AI model (Required before first use)
npx --no node-llama-cpp pull --dir ./models <model-file-url>
# Start KuttAI
npm start| Component | Minimum | Recommended |
|---|---|---|
| RAM | 8 GB | 16 GB or more |
| GPU | Not required | NVIDIA GPU with 4GB+ VRAM |
| Storage | 10 GB free space | 20 GB free space |
| Node.js | v18.0.0+ | v20.0.0+ |
| OS | Windows 10+, macOS 10.14+, Ubuntu 18.04+ | Latest OS version |
# After installation
npm start
# Or directly with node
node index.js| Command | Description | Example |
|---|---|---|
| Just type your question | Get answers about studies, exams, or KTU | What are the important topics for CS2040? |
/profile |
Set up your student profile | /profile set semester=4 department=CSE |
/help |
See all available commands | /help |
/about |
Learn more about KuttAI | /about |
Ctrl+C |
Exit the application | - |
┌──────────────────────────────────────────────────────────────────────────────┐
│ KuttAI CLI v1.1.0 │
├──────────────────────────────────────────────────────────────────────────────┤
│ You: What are the important topics for CS2040? │
│ │
│ KuttAI: Based on the current syllabus, the important topics for CS2040 │
│ include Data Structures, Algorithms, Trees, Graphs, and Sorting Algorithms. │
│ I recommend focusing on... │
│ │
│ You: When is the S4 CSE end semester exam? │
│ │
│ KuttAI: The S4 CSE end semester exams are scheduled for June 15-30, 2024. │
│ I suggest starting your preparation at least 6 weeks in advance. │
└──────────────────────────────────────────────────────────────────────────────┘
- ✅ Streaming output for real-time responses
- ✅ Improved animations and typewriter effects
- ✅ Tokenizer fixes
- ✅ GPU layer auto-detection
- ✅ Beautiful terminal UI with gradient colors
- ✅ Local AI model integration
- ✅ KTU-specific knowledge base
- ✅ Student profile system
- ✅ Conversation history
KuttAI uses a beautiful gradient color scheme inspired by modern design principles:
- 🔵 Blue (#1a237e → #1565c0): Information and system messages
- 🔴 Red (#b71c1c → #d32f2f): Errors and important notices
- 🟡 Yellow (#f57f17 → #fbc02d): Warnings and highlights
- 🟢 Green (#1b5e20 → #388e3c): Success messages and positive feedback
- Loading animations with spinning indicators
- Progress bars for model loading and long operations
- Typewriter effect for response display
- Smooth transitions between application states
- Real-time typing indicators
- Node.js - Runtime environment
- LLama.cpp - AI model integration via node-llama-cpp
- Custom UI Engine - Terminal interface rendering with blessed
- Local Storage - Data persistence with JSON files
KuttAI uses optimized AI models specifically trained for academic content:
- Model: hf_mradermacher_ClinIQ-Gemma-2B-v0-hf.IQ4_XS.gguf
- Size: Approximately 2B parameters
- Specialization: Educational content, KTU curriculum
- Download Size: ~1.5GB
- RAM Usage: ~4GB during operation
We love contributions! Here's how you can help:
# Fork and clone the repository
git clone https://github.com/cyberkutti-iedc/kuttai.git
cd kuttai
# Install dependencies
npm install
# Set up development environment
npm start
# Run tests
npm test
# Build for production
npm run build- 🐛 Bug fixes and issue resolution
- 💡 New feature implementation
- 📚 Documentation improvements
- 🎨 UI/UX enhancements
- 🔧 Performance optimizations
Please read our Contributing Guidelines, CLA, and Code of Conduct before contributing.
This project is licensed under the EcoCee-OpenSource License – see LICENSE for details. Ownership remains with Sreeraj V Rajesh & EcoCee. Contributions are welcome under the CLA.
- Developed by EcoCee
- Inspired by the needs of KTU students
- Built with the amazing Node.js ecosystem
- Thanks to all contributors and testers
- 📧 Email: info@ecocee.in
- 🐛 GitHub Issues
- 💬 Discord Community
Common Issues and Solutions:
-
Model Download Failed
# Manual download option npx --no node-llama-cpp pull --dir ./models <model-file-url>
-
Insufficient Memory
- Close other applications
- Add swap space (Linux/macOS)
-
Node Version Issues
# Update Node.js nvm install 18 nvm use 18 -
Display Problems
- Ensure your terminal supports ANSI colors
- Try using a different terminal emulator
- Voice Interaction - Speak to KuttAI and hear responses
- Multi-language Support - Assistance in Malayalam and Hindi
- Mobile App - KuttAI on your smartphone
- Plugin System - Extend functionality with community plugins
- Cloud Sync - Sync your preferences across devices
- Advanced Study Planner - Intelligent study schedule generator
