Skip to main content

A simple CLI for chatting with Google Gemini from your terminal

Project description

Terminal Gemini CLI

PyPI version
A lightweight command-line tool to interact with Google Gemini AI directly from your terminal.


🚀 Features

  • Chat with Google Gemini AI from your terminal
  • Minimal and fast
  • Works on Linux, macOS, and Windows
  • Easy installation via pip

📦 Installation

pip install terminal-gemini-cli

⚡ Usage

Run the CLI after installation:

terminal-gemini "Hello Gemini!"

You can also start an interactive session:

terminal-gemini

Example:

> terminal-gemini "Summarize the book Atomic Habits"

⚙️ Configuration

The CLI needs your Gemini API key. Set it as an environment variable:

export GEMINI_API_KEY="your_api_key_here"   # Linux/macOS
setx GEMINI_API_KEY "your_api_key_here"     # Windows (PowerShell)

📌 Development

Clone the repo and install in editable mode:

git clone https://github.com/yourusername/terminal-gemini.git
cd terminal-gemini
pip install -e .

Build and upload:

rm -rf dist/ build/ *.egg-info
python -m build
twine upload dist/*

🛠 Requirements


📄 License

MIT License. Feel free to fork and improve!


💡 Example

$ terminal-gemini "Write a haiku about the ocean"
🌊
Calm waves kiss the shore,  
Endless blue whispers softly,  
Sky and sea as one.

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

terminal_gemini_cli-0.1.2.tar.gz (2.7 kB view details)

Uploaded Source

Built Distribution

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

terminal_gemini_cli-0.1.2-py3-none-any.whl (3.5 kB view details)

Uploaded Python 3

File details

Details for the file terminal_gemini_cli-0.1.2.tar.gz.

File metadata

  • Download URL: terminal_gemini_cli-0.1.2.tar.gz
  • Upload date:
  • Size: 2.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for terminal_gemini_cli-0.1.2.tar.gz
Algorithm Hash digest
SHA256 b23eb370236ca66b31b579ab568bb3146b0e7c1ad9c78225a15d6d9a201a50a8
MD5 96a48e9fc62fe3a0dbb195ef4035b234
BLAKE2b-256 194469ea363e879e51a5d10acf2b7007b17001a48ce315d6e279196dac9b4f3a

See more details on using hashes here.

File details

Details for the file terminal_gemini_cli-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for terminal_gemini_cli-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1b98c00f1264e32fa342c4693ae784d3a53713f086db50391fb4bd271207279f
MD5 33696dc9e54c56359ce32eed6949518c
BLAKE2b-256 ade3834a2af052ffa1c0a8112904ed2280d300865a289411a6cdac45f35539ec

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