Skip to content

README.md

Latest commit

 

History

History
92 lines (65 loc) · 1.86 KB

README.md

File metadata and controls

92 lines (65 loc) · 1.86 KB

Genie CLI

Genie CLI is a local interactive AI assistant powered by Google Gemini API.
It can read and analyze your local code files, run Python scripts, and assist with debugging — all through a simple command-line interface.

Features

  • Interactive chat assistant for your projects.
  • Reads and analyzes local Python files.
  • Executes Python scripts and returns results.
  • Persistent local chat history.
  • Handles Gemini API quota limits gracefully.
  • Supports function calls for automation tasks in your code.

Requirements

Installation

  1. Clone the repository:
git clone https://github.com/Popie52/genie-cli.git
cd genie-cli
  1. Create a virtual environment (optional but recommended):
python -m venv .venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate     # Windows
  1. Install dependencies:
pip install -r requirements.txt
pip install uv
  1. Create a .env file in the root of the project and add your Gemini API key:
GEMINI_API_KEY=your_gemini_api_key_here

Usage

Start the interactive assistant:

uv run main.py

You will see:

Chat assistant ready! Type 'exit' to quit.
You:

  • Type your question or command.

  • The assistant will read local files, analyze code, or execute scripts as needed.

  • To exit, type:

exit

or

quit

Notes

  • Chat history is saved locally in chat_history.json. You can continue your conversation even after restarting.

  • If the Gemini API quota is exceeded, the assistant will inform you and resume after 24 hours.

  • Make sure your .env file is never pushed publicly.

Contributing

Contributions are welcome! Feel free to open issues, submit pull requests, or suggest new features.