KuttAI CLI - Your Intelligent Study Companion

🌟 Overview

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.

✨ Features

🚀 Quick Start

Method 1: Direct Run with npx (Recommended)

npx kuttai

Method 2: Manual Installation

# 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

⚙️ System Requirements

🎮 Usage Guide

Starting KuttAI

# After installation
npm start

# Or directly with node
node index.js

Basic Commands

Example Interaction

┌──────────────────────────────────────────────────────────────────────────────┐
│                              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.             │
└──────────────────────────────────────────────────────────────────────────────┘

Current Version: v1.1.0

• ✅ 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

🎨 UI/UX Features

Color Scheme

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

Animations & Effects

• 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

🔧 Technical Architecture

Built With

• 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

Model Information

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

🤝 Contributing

We love contributions! Here's how you can help:

Development Setup

# 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

Contribution Areas

• 🐛 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.

📝 License

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.

🙏 Acknowledgments

• Developed by EcoCee
• Inspired by the needs of KTU students
• Built with the amazing Node.js ecosystem
• Thanks to all contributors and testers

📞 Support

Documentation

• 📖 User Guide

Contact

• 📧 Email: info@ecocee.in
• 🐛 GitHub Issues
• 💬 Discord Community

Troubleshooting

Common Issues and Solutions:

1. Model Download Failed

   # Manual download option
   npx --no node-llama-cpp pull --dir ./models <model-file-url>

2. Insufficient Memory

   • Close other applications
   • Add swap space (Linux/macOS)

3. Node Version Issues

   # Update Node.js
   nvm install 18
   nvm use 18

4. Display Problems

   • Ensure your terminal supports ANSI colors
   • Try using a different terminal emulator

🔮 Roadmap

Upcoming Features

• 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

Current Version: v1.0.0

• ✅ Beautiful terminal UI with colors and animations
• ✅ Local AI model integration
• ✅ KTU-specific knowledge base
• ✅ Student profile system
• ✅ Conversation history