xcli-ai 1.0.0

A CLI assistant powered by local AI (Msty Studio) or OpenAI

x - Your Smart CLI Assistant

x is an AI-powered command-line interface assistant that helps you find and execute the right commands for your tasks. It supports local AI (via Msty Studio or MLX) and cloud AI (OpenAI) to convert natural language queries into system commands, with built-in safety confirmations and OS-specific command generation.

It came in a dream. "Thank you for this gift."

Features

• 🤖 Natural language to CLI command conversion
• 💡 Command explanations for better understanding
• ✅ Command confirmation before execution
• 🔒 Secure API key storage
• 🏠 Local AI support via Msty Studio - Run completely offline and private
• 🍎 MLX support - Apple Silicon optimized local AI
• ⚡ OpenAI - Hyper Speed Most Efficient (Fastest) - Fastest cloud AI option
• 💻 OS-specific command generation (macOS, Linux, Windows)
• 🎨 Rich terminal output formatting
• ⚙️ Easy configuration with x --configure

Installation

Option 1: Install from PyPI (Recommended)

pip install xcli-ai

Option 2: Install from Source

1. Clone the repository:

git clone https://github.com/caraveo/solai.git
cd solai
pip install -e .

Quick Start

After installation, you can use x or ! as commands:

Using Local AI (Msty Studio) - Recommended

1. Install and start Msty Studio

   • Download Msty Studio from: https://msty.ai
   • Launch Msty Studio and ensure it's running locally
   • Msty Studio typically runs on http://localhost:1234/v1

2. First-time setup

   • Run any x or ! command to trigger the setup wizard
   • Choose option 1 for "Local AI (Msty Studio)"
   • Enter your Msty Studio API base URL (default: http://localhost:1234/v1)
   • Enter your model name (default: mistral)
   • Configuration will be saved to ~/.solai.env

3. Run a command:

x find large files
# or
! find large files

Using MLX (Apple Silicon) - Optimized for Mac

1. Install and start MLX server

   • Set up an MLX-compatible server running locally
   • MLX server typically runs on http://localhost:11973/v1

2. First-time setup

   • Run any sol command to trigger the setup wizard
   • Choose option 2 for "MLX - Apple Silicon optimized local AI"
   • Enter your MLX API base URL (default: http://localhost:11973/v1)
   • Enter your model name (default: mlx-community/Qwen2.5-0.5B-Instruct-4bit)
   • Configuration will be saved to ~/.solai.env

3. Run a command:

x find large files
# or
! find large files

Using OpenAI - Hyper Speed Most Efficient (Fastest)

1. First-time setup

   • Run any sol command to trigger the setup wizard
   • Choose option 3 for "OpenAI - Hyper Speed Most Efficient (Fastest)"
   • Get your API key from: https://platform.openai.com/api-keys
   • Configuration will be securely stored in ~/.solai.env

2. Run a command:

x find large files
# or
! find large files

Example output:

Suggested command:
find ~ -type f -size +100M
→ Searches your home directory for files larger than 100 megabytes

Do you want to execute this command? [y/n]:

Usage Examples

# Find files
x find all pdf files in downloads
! find all pdf files in downloads

# System maintenance
x clean up system cache
! clean up system cache

# Network commands
x check if google.com is up
! check if google.com is up

# File operations
x create a backup of my documents
! create a backup of my documents

# With admin privileges
x --admin install package
x -a update system
! --admin install package

Development

To install in development mode:

git clone https://github.com/caraveo/solai.git
cd solai
pip install -e .

Requirements

• Python 3.6+
• For Local AI: Msty Studio installed and running
• For MLX: MLX server installed and running (Apple Silicon optimized)
• For OpenAI - Hyper Speed Most Efficient (Fastest): OpenAI API key
• Required packages:
  • click
  • python-dotenv
  • openai
  • rich

Configuration

Configuration is stored in ~/.solai.env. The setup wizard will guide you through the initial configuration.

Local AI Configuration (Msty Studio)

AI_PROVIDER=local
API_BASE_URL=http://localhost:1234/v1
API_KEY=not-needed
MODEL=mistral

MLX Configuration (Apple Silicon)

AI_PROVIDER=mlx
API_BASE_URL=http://localhost:11973/v1
API_KEY=not-needed
MODEL=mlx-community/Qwen2.5-0.5B-Instruct-4bit

OpenAI - Hyper Speed Most Efficient (Fastest) Configuration

AI_PROVIDER=openai
API_KEY=your-api-key-here
MODEL=gpt-3.5-turbo

To reconfigure, simply delete ~/.solai.env and run any sol command to trigger the setup process again.

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -am 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT License

Contact

Jon Caraveo - [e-mail]

Project Link: https://github.com/caraveo/solai