Skip to main content

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 rich and questionary)
  • 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

canoaicli-1.0.1.tar.gz (27.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

canoaicli-1.0.1-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

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

Hashes for canoaicli-1.0.1.tar.gz
Algorithm Hash digest
SHA256 6025a214850470c4ea12553db77358306bc9e2acd536f27fb869ad73a551d959
MD5 12a3a5b5709aeda95b07fa08595b8c4e
BLAKE2b-256 d8097d6fa5e02e31f7cefb4b7ecf3451755935f55f19d76503856914011a65c7

See more details on using hashes here.

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

Hashes for canoaicli-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a38c8c9277039891f9a279419eb59f8e3cc7ba21abf15da7c335a911f31fc6ed
MD5 ec3db0ca2b7b6ef46437db155621b922
BLAKE2b-256 1636e1861edfc69225d0738df2cd7c1492e6511ac7ccc61b13cd3999116f5ccc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page