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.0.tar.gz (27.4 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.0-py3-none-any.whl (5.4 kB view details)

Uploaded Python 3

File details

Details for the file canoaicli-1.0.0.tar.gz.

File metadata

  • Download URL: canoaicli-1.0.0.tar.gz
  • Upload date:
  • Size: 27.4 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.0.tar.gz
Algorithm Hash digest
SHA256 fc45b037f2e274d3417c76079af1c2d9178ded4b3615742ff816dad28aea44b4
MD5 d99d8952f0b60d80721d0d0dc7c91a3d
BLAKE2b-256 6628e0efa16d3ce984afbffe93db9abf230dbdbb027ff135a7328300ab929e56

See more details on using hashes here.

File details

Details for the file canoaicli-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: canoaicli-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 5.4 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 479143e91422bea5dc143fb1e232ffd1cee68e30e8b9b5cdbf38f410f9e61f2f
MD5 c30d2d8089b035e54337b3ce6383d425
BLAKE2b-256 9a1d6208e24816d593113bded6329560a02bffab157aab23b95e8671b004c4b7

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