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

Requirements

Python 3.12+
uv (recommended for development)

License

Internal -- see repository root for license details.

Release files for sec-gemini 3.4.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sec-gemini 3.4.10
File	Size	Uploaded
sec_gemini-3.4.10.tar.gz	235.8 kB	Sep 26, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for sec-gemini 3.4.10
File	Interpreter	ABI	Platform	Reset
sec_gemini-3.4.10-py3-none-any.whl 309.3 kB Sep 26, 2026	Python 3	none	any	Details

Total release size: 545.1 kB

Release files / sec_gemini-3.4.10.tar.gz

Download URL	sec_gemini-3.4.10.tar.gz
Size	235.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`395f5186f314d1a3c59ecd6074e84db8548d225681fc3b23fc7598e5a3c32831`
BLAKE2b-256 checksum How to use checksums	`a3893667facf48a71de409c279ccb50200b9c29cff4e8b810fd6d5474659e5d7`
Upload date	Sep 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / sec_gemini-3.4.10-py3-none-any.whl

Download URL	sec_gemini-3.4.10-py3-none-any.whl
Size	309.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2f1a00c4fabbba884ae05ec1acd68b03f63d35a3fc98e3295f7403908f0b93b4`
BLAKE2b-256 checksum How to use checksums	`78b3f7afe751d356e3c098fcbe217caee27118c9d4df6de11c4a08f0239f6cff`
Upload date	Sep 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`