A command-line AI assistant using Gemini
Project description
Canoaicli – AI in your terminal
Canoaicli is a minimalist and intelligent command-line tool. It lets you generate terminal commands from simple natural language instructions, powered by Google Gemini AI.
🚀 Installation
Make sure you have Python ≥ 3.11, then install it easily from PyPI:
pip install canoaicli
🧠 Configuration
Before starting, configure your Gemini API key (get one from Google AI Studio):
ai configure
This will prompt you for your API key, which will be stored securely on your system.
💡 Usage
Once installed and configured, use AI directly in your terminal:
ai <your command>
Examples:
ai how to list all docker containers
ai delete all git branches except main
The tool will show you the appropriate shell commands, clearly and ready to be copied or run.
🛠️ Features
- Generate bash/git/docker commands from natural language
- Fast and smooth usage
- Interactive interface (thanks to
richandquestionary) - Secure Gemini API key configuration
- Open source and extensible
📦 Local development
To contribute to the project:
git clone https://github.com/carellihoula/AssistantIACLI.git
cd AssistantIACLI
pixi shell
pixi install
📃 License
MIT
✨ Demo video
(coming soon) 🎥
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file canoaicli-1.0.1.tar.gz.
File metadata
- Download URL: canoaicli-1.0.1.tar.gz
- Upload date:
- Size: 27.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6025a214850470c4ea12553db77358306bc9e2acd536f27fb869ad73a551d959
|
|
| MD5 |
12a3a5b5709aeda95b07fa08595b8c4e
|
|
| BLAKE2b-256 |
d8097d6fa5e02e31f7cefb4b7ecf3451755935f55f19d76503856914011a65c7
|
File details
Details for the file canoaicli-1.0.1-py3-none-any.whl.
File metadata
- Download URL: canoaicli-1.0.1-py3-none-any.whl
- Upload date:
- Size: 5.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a38c8c9277039891f9a279419eb59f8e3cc7ba21abf15da7c335a911f31fc6ed
|
|
| MD5 |
ec3db0ca2b7b6ef46437db155621b922
|
|
| BLAKE2b-256 |
1636e1861edfc69225d0738df2cd7c1492e6511ac7ccc61b13cd3999116f5ccc
|