Skip to main content

An AI coding assistant CLI using Google's Gemini models with function calling.

Project description

Gemini Code

A powerful AI coding assistant for your terminal, powered by Gemini 2.5 Pro with support for other LLM models.

Features

  • Interactive chat sessions in your terminal
  • Multiple model support (Gemini 2.5 Pro, Gemini 1.5 Pro, and more)
  • Basic history management (prevents excessive length)
  • Markdown rendering in the terminal
  • Automatic tool usage by the assistant:
    • File operations (view, edit, list, grep, glob)
    • System commands (bash)
    • Web content fetching
    • Test running capabilities (pytest, etc.)

Installation

# Clone the repository
git clone https://github.com/raizamartin/gemini-code.git
cd gemini-code

# Install the package
pip install -e .

Setup

Before using Gemini CLI, you need to set up your API keys:

# Set up Google API key for Gemini models
gemini setup YOUR_GOOGLE_API_KEY

Usage

# Start an interactive session with the default model
gemini

# Start a session with a specific model
gemini --model models/gemini-2.5-pro-exp-03-25

# Set default model
gemini set-default-model models/gemini-2.5-pro-exp-03-25

# List all available models
gemini list-models

Interactive Commands

During an interactive session, you can use these commands:

  • /exit - Exit the chat session
  • /help - Display help information

How It Works

Tool Usage

Unlike direct command-line tools, the Gemini CLI's tools are used automatically by the assistant to help answer your questions. For example:

  1. You ask: "What files are in the current directory?"
  2. The assistant uses the ls tool behind the scenes
  3. The assistant provides you with a formatted response

This approach makes the interaction more natural and similar to how Claude Code works.

Development

This project is under active development. More models and features will be added soon!

Recent Changes in v0.1.69

  • Added test_runner tool to execute automated tests (e.g., pytest)
  • Fixed syntax issues in the tool definitions
  • Improved error handling in tool execution
  • Updated status displays during tool execution with more informative messages
  • Added additional utility tools (directory_tools, quality_tools, task_complete_tool, summarizer_tool)

Recent Changes in v0.1.21

  • Implemented native Gemini function calling for much more reliable tool usage
  • Rewritten the tool execution system to use Gemini's built-in function calling capability
  • Enhanced the edit tool to better handle file creation and content updating
  • Updated system prompt to encourage function calls instead of text-based tool usage
  • Fixed issues with Gemini not actively creating or modifying files
  • Simplified the BaseTool interface to support both legacy and function call modes

Recent Changes in v0.1.20

  • Fixed error with Flask version check in example code
  • Improved error handling in system prompt example code

Recent Changes in v0.1.19

  • Improved system prompt to encourage more active tool usage
  • Added thinking/planning phase to help Gemini reason about solutions
  • Enhanced response format to prioritize creating and modifying files over printing code
  • Filtered out thinking stages from final output to keep responses clean
  • Made Gemini more proactive as a coding partner, not just an advisor

Recent Changes in v0.1.18

  • Updated default model to Gemini 2.5 Pro Experimental (models/gemini-2.5-pro-exp-03-25)
  • Updated system prompts to reference Gemini 2.5 Pro
  • Improved model usage and documentation

Recent Changes in v0.1.17

  • Added list-models command to show all available Gemini models
  • Improved error handling for models that don't exist or require permission
  • Added model initialization test to verify model availability
  • Updated help documentation with new commands

Recent Changes in v0.1.16

  • Fixed file creation issues: The CLI now properly handles creating files with content
  • Enhanced tool pattern matching: Added support for more formats that Gemini might use
  • Improved edit tool handling: Better handling of missing arguments when creating files
  • Added special case for natural language edit commands (e.g., "edit filename with content: ...")

Recent Changes in v0.1.15

  • Fixed tool execution issues: The CLI now properly processes tool calls and executes Bash commands correctly
  • Fixed argument parsing for Bash tool: Commands are now passed as a single argument to avoid parsing issues
  • Improved error handling in tools: Better handling of failures and timeouts
  • Updated model name throughout the codebase to use gemini-1.5-pro consistently

Known Issues

  • If you created a config file with earlier versions, you may need to delete it to get the correct defaults:
    rm -rf ~/.config/gemini-code
    

License

MIT

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

gemini_code-0.1.97.tar.gz (33.2 kB view details)

Uploaded Source

Built Distribution

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

gemini_code-0.1.97-py3-none-any.whl (38.0 kB view details)

Uploaded Python 3

File details

Details for the file gemini_code-0.1.97.tar.gz.

File metadata

  • Download URL: gemini_code-0.1.97.tar.gz
  • Upload date:
  • Size: 33.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for gemini_code-0.1.97.tar.gz
Algorithm Hash digest
SHA256 faf121fbc4426fb5e74bac768c638b76f5df4d61f1573ba50097534e735f57da
MD5 8d7af1b4b33c823407d25a02210daaa1
BLAKE2b-256 b9c482ebebad49784b6533dca068e4b602da1db830b12ec44d8aa302cc6a3860

See more details on using hashes here.

File details

Details for the file gemini_code-0.1.97-py3-none-any.whl.

File metadata

  • Download URL: gemini_code-0.1.97-py3-none-any.whl
  • Upload date:
  • Size: 38.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for gemini_code-0.1.97-py3-none-any.whl
Algorithm Hash digest
SHA256 cb4376e065b35fdb6fb39d77909f2863dab42e357c176341c089b083f2381aa2
MD5 f66cd7891136066ac90a386e52556faf
BLAKE2b-256 3fa672379e616a2cb9b8a2aa6c9942fae46a134716a9f64081da8956c370f02f

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