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.12

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.12
File	Size	Uploaded
sec_gemini-3.4.12.tar.gz	237.1 kB	Sep 26, 2026	Details

Built distribution (wheel)

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

Total release size: 547.8 kB

Release files / sec_gemini-3.4.12.tar.gz

Download URL	sec_gemini-3.4.12.tar.gz
Size	237.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`2dbbddf9ee01f5eaf1246331d97a07f1f9f95f3242a9a50310b03f15c769fbfa`
BLAKE2b-256 checksum How to use checksums	`46953d0583e3307548732414c4559b7f878b9255388a2504cd0b92ad1a4cfc28`
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.12-py3-none-any.whl

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