Solai is an AI-powered command-line interface assistant that helps you find and execute the right commands for your tasks. It uses OpenAI's GPT 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."
- π€ Natural language to CLI command conversion
- π‘ Command explanations for better understanding
- β Command confirmation before execution
- π Secure API key storage
- π» OS-specific command generation (macOS, Linux, Windows)
- π¨ Rich terminal output formatting
pip install solai
- Clone the repository:
git clone https://github.com/caraveo/solai.git
cd solai
pip install -e .
-
First-time setup will prompt for your OpenAI API key
- Get your API key from: https://platform.openai.com/api-keys
- The key will be securely stored in
~/.solai.env
-
Run a command:
sol 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]:
# Find files
sol find all pdf files in downloads
# System maintenance
sol clean up system cache
# Network commands
sol check if google.com is up
# File operations
sol create a backup of my documents
To install in development mode:
git clone https://github.com/caraveo/solai.git
cd solai
pip install -e .
- Python 3.6+
- OpenAI API key
- Required packages:
- click
- python-dotenv
- openai
- rich
The OpenAI API key is stored in ~/.solai.env
. To update it, simply delete this file and run any sol command to trigger the setup process again.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -am 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
MIT License
Jon Caraveo - jon@ziavision.com
Project Link: https://github.com/caraveo/solai