An intelligent, AI-enhanced terminal shell with advanced features, beautiful theming, and powerful command execution capabilities.
Features • Installation • Quick Start • Documentation • Contributing
VritraAI is a next-generation AI-powered terminal shell that combines the power of traditional Unix commands with cutting-edge artificial intelligence. Built from scratch by Alex Butler of Vritra Security Organization, VritraAI transforms your terminal experience with intelligent command explanations, code analysis, project management, and a beautiful, customizable interface.
ai <prompt> for any question or taskexplain <command> or explain_lastreview <file|directory>security_scan <file|directory>optimize_code <file>refactor <file> <description>learn <topic> for any programming conceptcheat <topic>generate <description>summarize [path] for deep insights
VritraAI in action - AI-powered terminal shell with beautiful theming
Install VritraAI directly from PyPI:
pip install vritraai
For development or to get the latest features:
# Clone the repository
git clone https://github.com/VritraSecz/VritraAI.git
cd VritraAI
# Install dependencies
pip install -r requirements.txt
# Run directly
python vritraai.py
openai==0.28.0 - OpenAI API client for OpenRouter integrationrequests>=2.28.0 - HTTP library for API requestsprompt-toolkit>=3.0.0 - Advanced terminal UI libraryrich>=13.0.0 - Rich text and beautiful terminal formattingpygments>=2.13.0 - Syntax highlighting for code displaypsutil>=5.9.0 - System and process utilitiesblack>=23.0.0 - Python code formatter (for format_file command)autopep8>=2.0.0 - Alternative Python code formatter# Install all dependencies
pip install -r requirements.txt
# Install only core dependencies
pip install openai requests prompt-toolkit rich
# Install with optional features
pip install openai requests prompt-toolkit rich pygments psutil black autopep8
# After installation
vritraai
# Or run directly
python vritraai.py
# Set up Gemini API (default)
apikey gemini YOUR_GEMINI_API_KEY
# Or set up OpenRouter API
apikey openrouter YOUR_OPENROUTER_API_KEY
# Ask AI questions
ai How do I use git rebase?
# Explain last command
ls -la
explain_last
# Review code
review myfile.py
# Learn something new
learn "bash loops"
# Change theme
theme cyberpunk
# Change prompt style
prompt hacker
# View all options
theme
prompt
VritraAI supports the following command-line flags:
| Flag | Long Form | Description |
|---|---|---|
-h | --help | Show help message and exit |
-v | --version | Show version information and exit |
-i | --interactive | Launch in interactive mode (default) |
# Show help
python vritraai.py -h
python vritraai.py --help
# Show version
python vritraai.py -v
python vritraai.py --version
# Launch interactive mode (default)
python vritraai.py -i
python vritraai.py --interactive
# Launch without flags (same as -i)
python vritraai.py
Note: Only one flag can be used at a time. Using multiple flags will result in an error.
VritraAI provides a powerful interactive shell with:
Tab to autocomplete commands and paths↑/↓ arrows to navigate command history\ for line continuation; or && to chain commands|)VritraAI includes 100+ built-in commands. Here are the top 20 most commonly used commands:
| Command | Description |
|---|---|
ai <prompt> | Natural language AI assistant |
explain_last | Explain the last executed command |
review <file|directory> | AI-powered code review |
ls [path] | Colored directory listing |
read_file <file> | Read file with syntax highlighting |
edit_file <file> | Open file in editor or create new |
cd <directory> | Change directory |
theme [name] | Change color theme (37 available) |
prompt [style] | Change prompt style (60+ available) |
config | Show current configuration |
apikey <provider> <key> | Set API key (gemini/openrouter) |
model [list|set|search] | Manage AI models |
project_type | Detect project type automatically |
sys_info | Comprehensive system information |
search_file <pattern> [path] | Search for files by name |
find_files <pattern> [path] | Advanced file search with regex |
summarize [path] | AI-powered directory/file analysis |
learn <topic> | Interactive AI tutoring |
doc readme | Generate README.md for project |
history | View command history |
💡 Note: For a complete list of all commands, use the
helpcommand in VritraAI or visit vritraai.vritrasec.com/ for detailed documentation.
VritraAI can explain any system command you execute:
# Execute a command
ls -lah /usr/bin
# Get AI explanation
explain_last
The AI will provide:
Get intelligent code analysis:
review myfile.py
Features:
Automatic project analysis:
# Detect project type
project_type
# Check dependencies
dependencies_check
# Analyze project health
project_health
Interactive learning:
learn "bash loops"
learn "git rebase"
learn "python decorators"
Provides:
The explain_last command provides intelligent analysis of your last executed command.
The following built-in commands are automatically logged:
ls, dir, search_file, find_fileshash, validate, formatsearch_regex, cd, sys_infodisk_usage, env, path, whichuptime, memory, processestime, calc, templateencode, decode# Execute any system command
grep -r "pattern" /path/to/search
# Get explanation
explain_last
VritraAI supports command chaining with strict validation for safety.
; - Sequential execution (always executes)&& - Conditional execution (executes if previous succeeds)File Operations:
ls, dir, read_file, search_file, mkdir, create_dirfind_files, compare, diff, hash, validate, format, treeSystem Commands:
cd, clear, exit, help, sys_info, disk_usageenv, path, which, uptime, memory, processestime, calc, config, template, theme, promptencode, decode, network, analyze_systemAPI/Model Management:
apikey, api_base, model# Valid: System commands
ls -la; cd /tmp; pwd
# Valid: Mixed system and built-ins
ls; sys_info; memory
# Invalid: AI commands (must be separate)
ls; ai "what is this?" # ❌ Error: AI command detected
# Valid: Pipes work normally
ls -la | grep ".py"
VritraAI includes 37 professionally designed color themes. Here are the top 10 most popular themes:
| Theme | Description |
|---|---|
| dark | Default dark terminal theme |
| light | Light theme with classic colors |
| matrix | Matrix-style green hacker terminal |
| cyberpunk | High-contrast cyberpunk palette |
| galaxy | Space/galaxy purples and blues |
| ocean | Cool blue ocean-inspired theme |
| neon | Bright neon accents for high contrast |
| retro | Retro neon green-on-black look |
| hacker_green | Aggressive hacker green-on-black |
| synthwave | 80s synthwave neon palette |
💡 Note: VritraAI includes 27 more themes! Use
themecommand to see all available themes, or visit vritraai.vritrasec.com/ for the complete list.
# List all themes
theme
# Change theme
theme cyberpunk
# Reset to default
theme reset
VritraAI offers 60+ creative prompt styles to personalize your terminal:
┌──(user㉿vritraai)-[path]\n└─$wake up, neo:// path $▶ path ◀⚡ path ⚡🏴☠️ [CAPTAIN] @ path ⚓🦸 [HERO] :: path >>🤖 [SYSTEM] :: path >>👽 [PROBE] ~~ path 🛸Classic Styles:
classic, minimal, modern, powerline, git, elegantTech Styles:
hacker, cyberpunk, matrix, code_matrix, terminal_classicFun Styles:
ninja, pirate, superhero, robot, alien, magicalmedieval, western, steampunk, gamingProfessional Styles:
corporate, professional, elegant, minimal_zenNature Styles:
space, fire, water, earth, airmountain, jungle, desert, arcticAnd many more!
💡 Note: VritraAI includes 60+ prompt styles! Use
promptcommand to see all available styles, or visit vritraai.vritrasec.com/ for the complete list.
# List all prompt styles
prompt
# Change prompt style
prompt hacker
# Reset to default
prompt reset
VritraAI uses a unified configuration system with automatic persistence.
~/.config-vritrasecz/vritraai/~/.config-vritrasecz/vritraai/config.json~/.config-vritrasecz/vritraai/history~/.config-vritrasecz/vritraai/session.log~/.config-vritrasecz/vritraai/lastcmd.log~/.config-vritrasecz/vritraai/learning.md~/.config-vritrasecz/vritraai/vritraai-version.json~/.config-vritrasecz/vritraai/config.json.backup (automatic backup)# Show current configuration
config
Configuration is automatically saved when you:
theme <name>)prompt <style>)apikey <provider> <key>)api_base <provider>)model set <id>)VritraAI supports two AI providers: Gemini (default) and OpenRouter.
apikey gemini YOUR_GEMINI_API_KEY
gf1 - Gemini 2.0 Flash (default)gf2 - Gemini 2.5 Flashgf3 - Gemini 2.5 Flash Litegf4 - Gemini Flash Latestgp1 - Gemini 2.5 Proapikey openrouter YOUR_OPENROUTER_API_KEY
api_base openrouter
# List available models
model list
# Set model
model set gf1
# Search models
model search flash
# Set Gemini API key
apikey gemini YOUR_KEY
# Set OpenRouter API key
apikey openrouter YOUR_KEY
# View API key help
apikey help
VritraAI includes an intelligent error recovery system with AI-powered suggestions.
When an error occurs, you'll see:
# If an error occurs during file operation
edit_file nonexistent.py
# VritraAI will:
# 1. Detect the error
# 2. Analyze the context
# 3. Suggest fixes (e.g., "File doesn't exist. Create it?")
# 4. Offer recovery options
VritraAI provides comprehensive file management features:
Quick project scaffolding:
# Create Python template
template python my_script.py
# Create Bash template
template bash script.sh
# Create HTML template
template html index.html
# Create README template
template readme README.md
# Search by pattern
search_file "*.py"
# Advanced search
find_files "test.*\.py$"
# Regex search
search_regex "def.*test" *.py
VritraAI enhances standard system commands with additional features:
ls: Colored output with file type indicatorscd: Smart directory navigation with error recoverygrep: Highlighted search resultscat: Syntax-highlighted file display# Comprehensive system info
sys_info
# Disk usage
disk_usage /home
# Memory stats
memory
# Process list
processes
# System uptime
uptime
# View environment variable
env PATH
# Set environment variable
env MY_VAR "value"
# PATH management
path add /new/path
The following commands require confirmation:
rm -rf, rm -rfv, rm *dd, mkfs, fdiskshutdown, reboot, haltchmod 777, chown -Rsudo rm, sudo dd> /dev/null, truncate, shred~/.config-vritrasecz/vritraai/config.jsonVritraAI is fully compatible with Termux on Android.
# Update packages
pkg update && pkg upgrade
# Install Python
pkg install python
# Install pip packages
pip install vritraai
# Or clone and install
git clone https://github.com/VritraSecz/VritraAI.git
cd VritraAI
pip install -r requirements.txt
VritraAI is designed primarily for Linux systems.
# Using pip (recommended)
pip install vritraai
# Or from source
git clone https://github.com/VritraSecz/VritraAI.git
cd VritraAI
pip install -r requirements.txt
Most Linux distributions include Python 3.7+ by default. Install additional dependencies as needed:
# Ubuntu/Debian
sudo apt-get install python3-pip python3-venv
# Fedora
sudo dnf install python3-pip
# Arch Linux
sudo pacman -S python-pip
head or tail for large filesVritraAI/
├── vritraai.py # Main application file
├── config_manager.py # Unified configuration system
├── config.py # Legacy configuration (fallback)
├── requirements.txt # Python dependencies
├── setup.py # PyPI package setup script
├── pyproject.toml # Modern Python project configuration
├── MANIFEST.in # Package manifest for PyPI
├── README.md # This file
├── LICENSE # MIT License file
└── CHANGELOG.md # Version history and changelog
User Configuration Directory:
~/.config-vritrasecz/vritraai/
├── config.json # Configuration file
├── config.json.backup # Automatic config backup
├── .config.lock # Configuration lock file (internal)
├── history # Command history
├── session.log # Session log
├── lastcmd.log # Last command log
├── learning.md # Learning notes (from `learn` command)
└── vritraai-version.json # Version information file
vritraai.py: Main application (13,820+ lines)config_manager.py: Configuration management systemconfig.py: Legacy configuration fallbackrequirements.txt: All project dependenciessetup.py: PyPI package setup scriptpyproject.toml: Modern Python project configuration (PEP 518)MANIFEST.in: Package manifest for including files in PyPI distributionLICENSE: MIT License fileCHANGELOG.md: Version history and changelog documenting all notable changesWe welcome contributions to VritraAI! This is an open-source project built from scratch, and your contributions help make it better.
Fork the Repository
git clone https://github.com/VritraSecz/VritraAI.git
cd VritraAI
Create a Branch
git checkout -b feature/your-feature-name
Make Your Changes
Commit Your Changes
git commit -m "Add: Description of your changes"
Push to Your Fork
git push origin feature/your-feature-name
Create a Pull Request
# Clone repository
git clone https://github.com/VritraSecz/VritraAI.git
cd VritraAI
# Create virtual environment
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Run in development mode
python vritraai.py
This project is licensed under the MIT License.
MIT License
Copyright (c) 2024 Alex Butler, Vritra Security Organization
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Alex Butler
Owner, Vritra Security Organization
help command in VritraAI for comprehensive command referenceWe value your feedback! Please:
Made with ❤️ by Alex Butler | Vritra Security Organization
No reviews yet. Be the first to rate this tool.
Sign in to leave a review.