Sec-Gemini Python SDK

Python SDK, terminal client, MCP server, and BYOT tunnel for the Sec-Gemini security AI agent.

Install

pip install sec-gemini

Set your API key

Get an API key from secgemini.google/keys, then:

sec-gemini set-key

What's included

• Terminal UI (sec-gemini) -- interactive chat with the agent
• Python SDK -- async client for programmatic access
• MCP server (sec-gemini-mcp) -- expose the SDK to AI assistants
• BYOT client (sec-gemini-byot) -- connect local tools to the cloud agent
• 35 baseline tools in 5 categories: file operations, shell, Python execution, JavaScript execution, and network analysis

Quick start

Terminal UI -- interactive chat with the agent:

# Standard launch
sec-gemini

# Launch with local MCP scripts (BYOT "magic" mode)
sec-gemini --mcp ./my_tools.py

Tip: Local scripts passed via --mcp appear in the "Bring Your Own MCP" section and are automatically functional in new sessions. Requires fastmcp installed.

Python SDK -- programmatic access:

import asyncio
from sec_gemini.services.backend import Backend

async def main():
    backend = Backend(api_key="YOUR_KEY")
    await backend.connect()
    session = await backend.create_session()
    await backend.send_prompt(session.session_id, "Analyze example.com")
    async for msg in backend.stream_messages(session.session_id):
        print(f"[{msg.message_type}] {msg.content[:200]}")
    await backend.close()

asyncio.run(main())

MCP server -- expose the SDK to AI assistants (Claude Code, Gemini CLI):

sec-gemini-mcp

BYOT -- connect local tools to the cloud agent:

# Minimal: connect with base local tools (enabled by default)
uvx --from sec-gemini sec-gemini-byot

# Connect additional MCPs and local skills
uvx --from sec-gemini sec-gemini-byot --mcp ./my_tools.py --skills ./my_skill.md

Security notice: BYOT base tools (shell, file, Python, JavaScript) run directly on your machine with no sandboxing. Run inside a container or VM. See the BYOT Guide for details.

Documentation

Full documentation, guides, and API reference: secgemini.google

• Installation & Quick Start
• TUI Guide
• Python SDK Guide
• BYOT Guide
• Configuration Reference

Requirements

• Python 3.12+
• uv (recommended for development)

License

Internal -- see repository root for license details.