Gemini Agent

Python wrapper for Google's Gemini CLI agentic capabilities.

Installation

pip install gemini-agent            # client only
pip install gemini-agent[core]      # + direct CLI usage
pip install gemini-agent[server]    # + REST API service

Requirements: Node.js 18+ and npm install -g @google/gemini-cli

Quick Start

export GEMINI_API_KEY=your_key

from gemini_agent.core import GeminiAgent

agent = GeminiAgent()
result = agent.run("Create a Python CLI that lists files")

print(result.response)        # Gemini's response
print(result.modified_files)  # {"cli.py": "import os..."}

Usage

Direct CLI Wrapper

from gemini_agent.core import GeminiAgent

agent = GeminiAgent(
    model="gemini-2.5-flash",  # optional
    sandbox=True,              # isolated execution
)

result = agent.run(
    "Build a REST API with FastAPI",
    mcp_servers=["filesystem"],
    files={"spec.txt": "..."},
)

# result.success, result.response, result.modified_files

Python Client (Remote)

from gemini_agent.client import GeminiAgentClient

async with GeminiAgentClient("http://localhost:8000") as client:
    result = await client.run("Create a hello world script")
    print(result.modified_files)

REST API

podman-compose up -d --build

# Submit task
curl -X POST http://localhost:8000/tasks \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a fibonacci function"}'

# Get result
curl http://localhost:8000/tasks/{task_id}

API Endpoints

Configuration

License

MIT