🚀 AMVKA 2.0 - Universal AI Command Assistant

🎯 Universal AI Assistant - 100+ Providers, Real-time Intelligence, Zero Configuration Hassle!
AMVKA 2.0 is the next-generation AI-powered command assistant with universal provider support. Powered by LangChain, it works with 100+ AI providers and provides both intelligent command generation and conversational AI responses. Just ask naturally - get commands for system operations or direct answers for knowledge questions!
⚡ Quick Start
pip install amvka
pip install langchain-openai
pip install langchain-google-genai
pip install langchain-anthropic
pip install langchain-groq
pip install langchain-cohere
amvka config
amvka "who is the president of america"
amvka "list all python files"
amvka "what is machine learning"
amvka "create backup of current folder"
✨ Key Features
- 🌐 Universal AI Support: 100+ providers via LangChain (OpenAI, Gemini, Claude, Groq, Azure, AWS, Ollama, HuggingFace, Cohere, etc.)
- � Real-Time Intelligence: Live model fetching prevents outdated model errors
- 🤖 Dual Response Mode: Commands for system operations + direct answers for knowledge questions
- 🎯 Smart Model Filtering: Only shows working chat models (excludes TTS/Whisper/embeddings)
- ⚡ Lightning Fast: Ultra-fast providers like Groq for instant responses
- � Production Ready: Connection testing, fallback models, comprehensive error handling
- 🛡️ Enhanced Safety: Multi-layer validation, timeout protection, dangerous command detection
- 🌍 Cross-Platform: Windows (PowerShell), macOS, Linux with environment-specific optimization
🌐 Universal AI Provider Support (9 Core + 90+ Extended)
AMVKA 2.0 supports 100+ AI providers through LangChain with real-time model discovery:
🔥 Core Providers (Fully Integrated)
| 1 | OpenAI | Fast | GPT-4o, GPT-3.5 | pip install langchain-openai | Get Key |
| 2 | Google Gemini | Fast | Gemini 2.0 Flash, 1.5 Pro | pip install langchain-google-genai | Get Key |
| 3 | Anthropic Claude | Fast | Claude 3.5 Sonnet, Haiku | pip install langchain-anthropic | Get Key |
| 4 | Groq | ⚡ Ultra-Fast | Llama 3.3, Mixtral, Gemma | pip install langchain-groq | Get Key |
| 5 | Cohere | Fast | Command R+, Command R | pip install langchain-cohere | Get Key |
| 6 | Azure OpenAI | Enterprise | GPT-4, GPT-3.5 | pip install langchain-openai | Setup Guide |
| 7 | AWS Bedrock | Enterprise | Claude, Llama, Titan | pip install langchain-aws | Setup Guide |
| 8 | Ollama | 🏠 Local | Llama, CodeLlama, Mistral | pip install langchain-community | No API Key (Local) |
| 9 | Hugging Face | Variable | Open Source Models | pip install langchain-huggingface | Get Key |
⚡ Real-Time Features
- 🔍 Live Model Discovery: Fetches current available models from provider APIs
- 🎯 Smart Filtering: Only shows working chat models (excludes TTS/Whisper/embeddings)
- ✅ Connection Testing: Validates API keys and model access before saving
- 🔄 Automatic Fallbacks: Switches to working models if primary model fails
🚀 Extended Support (90+ Additional Providers)
Through LangChain ecosystem: Together AI, Replicate, Anyscale, Fireworks AI, Modal, Baseten, Banana, DeepInfra, ForefrontAI, GooseAI, NLP Cloud, Petals, PredictionGuard, PromptLayer, Runhouse, StochasticAI, Writer, and many more!
� Installation & Setup
🎯 Method 1: PyPI Installation (Recommended)
pip install amvka
pip install langchain-openai
pip install langchain-google-genai
pip install langchain-anthropic
pip install langchain-groq
pip install langchain-cohere
pip install langchain-openai langchain-google-genai langchain-groq
🏗️ Method 2: Development Installation
git clone https://github.com/amvka/amvka.git
cd amvka
pip install -e .
pip install -r requirements.txt
🔧 Method 3: Docker Installation
docker pull amvka/amvka:latest
docker run -it --rm amvka/amvka:latest
docker build -t amvka .
docker run -it --rm amvka
⚙️ Intelligent Setup Process
AMVKA 2.0 features an intelligent setup with real-time model discovery:
amvka config
🔍 Real-Time Intelligence Features:
- Live Model Discovery: Fetches current models from provider APIs
- Smart Filtering: Shows only working chat models (excludes TTS/Whisper)
- Connection Validation: Tests API key and model before saving
- Fallback Detection: Identifies backup models for reliability
- Provider Comparison: Shows speed, cost, and capability differences
Configuration Commands:
amvka config
amvka config --show
amvka config --reset
amvka config --test
🎯 Dual-Mode Usage Examples
AMVKA 2.0 intelligently handles both system commands and knowledge questions:
🖥️ System Command Mode
amvka "list all python files"
amvka "create backup of current folder"
amvka "find large files over 100MB"
amvka "check memory usage"
amvka "show running processes"
amvka "check disk space"
amvka "commit changes with message 'fix'"
amvka "push to main branch"
amvka "show git status"
amvka "install numpy package"
amvka "run python script test.py"
amvka "build docker image"
💬 Conversational AI Mode
amvka "who is the president of america"
amvka "what is machine learning"
amvka "explain quantum computing"
amvka "how does blockchain work"
amvka "hello"
amvka "help"
amvka "what can you do"
amvka "difference between python and java"
amvka "best practices for git"
amvka "explain REST APIs"
Command Line Options
amvka [OPTIONS] QUERY
Options:
-y, --yes Auto-confirm command execution (skip confirmation)
--dry-run Show suggested command without executing
-v, --version Show version information
--help Show help message
Commands:
config Configure API settings
--reset Reset configuration
--show Show current configuration
🔧 Configuration
API Providers
Amvka supports two AI providers:
Google Gemini (Recommended)
- Visit Google AI Studio
- Sign in with your Google account
- Create a new API key
- Run
amvka config and paste your key
OpenAI
- Visit OpenAI API Keys
- Sign in to your OpenAI account
- Create a new API key
- Run
amvka config and paste your key
Configuration File
Your configuration is stored in ~/.amvka/config.json:
{
"provider": "gemini",
"api_key": "your-api-key-here",
"model": "gemini-pro",
"safety_confirmation": true
}
Managing Configuration
amvka config --show
amvka config --reset
amvka config
🛡️ Enhanced Safety & Security
AMVKA 2.0 implements multi-layer security with production-grade safety measures:
🔒 1. Provider-Level Security
- Secure API Key Storage: Encrypted local configuration
- Connection Validation: Real-time API key verification
- Model Filtering: Only verified chat models (excludes dangerous tools)
- Rate Limit Handling: Respects provider API limits
🛡️ 2. Command Safety Validation
❌ Blocked: rm -rf /, sudo rm, dd if=, mkfs., shutdown
❌ Blocked: curl | bash, wget | sh, eval $(dangerous)
❌ Blocked: chmod 777, chown root, systemctl stop
✅ Safe: ls, cat, grep, find, ps, df, git status
⚡ 3. Execution Protection
- Timeout Protection: 30-second maximum execution time
- Environment Isolation: No direct root/admin access
- User Confirmation: Interactive approval for all commands
- Dry-Run Mode: Preview commands without execution
- Emergency Cancellation: Ctrl+C support during execution
🎯 4. Intelligent Risk Assessment
🟢 SAFE: File listing, information queries, git status
🟡 CAUTION: File modifications, package installation
🔴 DANGEROUS: System changes, network operations, root commands
🚫 BLOCKED: Destructive operations, security bypasses
📊 5. Audit & Monitoring
- Command Logging: Optional execution history
- Error Tracking: Detailed failure analysis
- Performance Metrics: Response time monitoring
- Usage Statistics: Provider and model analytics
🔍 How AMVKA 2.0 Works
🧠 Intelligent Processing Pipeline
graph LR
A[Natural Language Input] --> B[Query Classification]
B --> C{Command or Conversation?}
C -->|Command| D[LangChain Provider]
C -->|Conversation| E[Direct AI Response]
D --> F[Safety Validation]
F --> G[User Confirmation]
G --> H[Secure Execution]
E --> I[Display Answer]
🎯 Step-by-Step Process
- 🗣️ Natural Input: You ask in plain English
- 🤖 AI Classification: Determines if system command or knowledge question
- 🌐 Universal Provider: Routes to your configured AI (OpenAI/Gemini/Claude/Groq/etc.)
- 🔍 Real-Time Processing:
- Commands: Generates platform-specific shell commands
- Conversations: Provides direct informative responses
- 🛡️ Safety Validation: Multi-layer security checks
- ✅ User Confirmation: Interactive approval (unless
--yes flag)
- ⚡ Secure Execution: Sandboxed command execution with timeout
🚀 Advanced Features
- 🔄 Fallback System: Auto-switches to backup models if primary fails
- 🎯 Context Awareness: Remembers environment and previous interactions
- 📱 Cross-Platform: Adapts commands for Windows/macOS/Linux
- ⚡ Performance Optimization: Caching and smart model selection
🌟 What Makes AMVKA 2.0 Special
🆚 vs. Other AI Assistants
| Universal Providers | ✅ 100+ via LangChain | ❌ OpenAI Only | ❌ Limited |
| Real-Time Models | ✅ Live API Fetching | ❌ Static List | ❌ Manual |
| Command + Chat | ✅ Dual Mode | ❌ Chat Only | ❌ Commands Only |
| Safety Validation | ✅ Multi-Layer | ❌ Basic | ❌ Minimal |
| Local Support | ✅ Ollama Integration | ❌ Cloud Only | ❌ Limited |
| Production Ready | ✅ Enterprise Grade | ❌ Experimental | ❌ Hobby Projects |
🎯 Perfect For
- 👩💻 Developers: Command generation, git operations, deployment tasks
- 🔧 System Admins: Server management, monitoring, automation
- 📊 Data Scientists: File processing, environment setup, analysis tasks
- 🎓 Students: Learning commands, understanding concepts, quick help
- 🏢 Enterprises: Standardized tooling, multi-provider flexibility
📝 Development
Building from Source
git clone https://github.com/amvka/amvka.git
cd amvka
python3 -m venv venv
source venv/bin/activate
pip install -e .
pip install -e .[dev]
Building Debian Package
sudo apt-get install build-essential debhelper dh-python python3-setuptools
dpkg-buildpackage -us -uc
sudo dpkg -i ../amvka_1.0.0-1_all.deb
Running Tests
python -m pytest tests/
python -m pytest --cov=amvka tests/
🤝 Contributing
We welcome contributions! Please see our Contributing Guidelines for details.
Areas for Contribution
- Additional AI provider support
- Enhanced safety checks
- More comprehensive command validation
- Better error handling
- Documentation improvements
📋 System Requirements
🖥️ Platform Support
- Windows: PowerShell 5.1+, CMD, Windows Terminal ✅
- macOS: Terminal.app, iTerm2, zsh, bash ✅
- Linux: bash, zsh, fish, any terminal ✅
🐍 Python Requirements
- Python 3.8+ (recommended: 3.9+)
- Internet connection for AI API calls
- Optional: Local AI models via Ollama (offline mode)
📦 Core Dependencies
langchain>=0.1.0
langchain-community>=0.0.10
requests>=2.31.0
click>=8.0.0
colorama>=0.4.0
langchain-openai
langchain-google-genai
langchain-anthropic
langchain-groq
langchain-cohere
langchain-aws
langchain-huggingface
⚠️ Important Disclaimers
Safety Notice
- Always review commands before execution
- Amvka is designed to be safe, but AI can make mistakes
- Never run commands you don't understand
- Be extra cautious with file operations and system commands
API Usage
- You are responsible for your API usage and costs
- Monitor your API usage on your provider's dashboard
- Keep your API keys secure and never share them
Limitations
- Requires internet connection for AI processing
- Subject to AI provider rate limits
- Command suggestions may not always be optimal
- Some complex operations may require manual command crafting
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
📞 Support
🗺️ Roadmap & Future Vision
✅ AMVKA 2.0 (Current - Released)
- ✅ Universal AI provider support (100+ via LangChain)
- ✅ Real-time model discovery and validation
- ✅ Dual-mode: Commands + Conversational AI
- ✅ Enhanced safety and security measures
- ✅ Cross-platform support (Windows/macOS/Linux)
- ✅ Production-grade error handling and fallbacks
🚀 AMVKA 2.1 (Q1 2025)
🌟 AMVKA 2.5 (Q2 2025)
🎯 AMVKA 3.0 (Q4 2025)
🔮 Long-term Vision
- Universal DevOps Assistant: Complete infrastructure management
- AI-Powered Documentation: Auto-generated guides and tutorials
- Predictive Operations: AI suggests optimizations and fixes
- Natural Language Programming: Code generation and debugging
- Enterprise AI Platform: Complete organizational AI toolkit
🏆 Why Choose AMVKA 2.0?
🎯 For Individuals
- ⚡ Lightning Fast: Ultra-fast providers like Groq for instant responses
- 🧠 Smart Learning: Remembers your preferences and context
- 💰 Cost Effective: Choose from free (Ollama) to premium providers
- 🔒 Privacy Focused: Local options available, secure key storage
🏢 For Organizations
- 🌐 Universal: Works with any AI provider, no vendor lock-in
- 🛡️ Enterprise Security: Comprehensive safety and audit capabilities
- 📈 Scalable: From single developers to large teams
- 🔧 Customizable: Extensible architecture for specific needs
🚀 Made with ❤️ by the AMVKA Team
AMVKA 2.0 - Bridging the gap between human language and computer commands. Making AI accessible, powerful, and safe for everyone.
⭐ Star us on GitHub | 🔗 Share with friends | 🎯 Join the AI revolution