Notebooks

Interactive notebooks you can run in Colab or locally. Each covers a different aspect of the SDK.

Basic SDK Usage

Connect, create sessions, send prompts, stream responses, upload files, and clean up.

Covers: SecGemini client, session.prompt(), session.messages.stream(), session.files.upload(), session management.

SDK + BYOT + Custom MCP

Use the SDK alongside BYOT with baseline tools and a custom FastMCP server you define inline.

Covers: FastMCP custom tools, ByotService, create_baseline_mcp(), combining baseline + custom tools, streaming results.

SDK and TUI Overview

General overview demo covering the SDK, TUI, and BYOT client.

Covers: Client setup, sessions, skills listing, prompting, streaming, BYOT overview.

Using Skills

Create, upload, and use skills to guide the agent’s behavior.

Covers: client.skills.upload(), client.skills.list_uploaded(), using skills in sessions.

CyberGym Challenges

Solve CyberGym challenges using specific MCPs.

Covers: Custom MCP configuration, passing metadata to sessions, solving challenges.

Running Locally

You can also run the notebooks locally:

pip install sec-gemini jupyter
jupyter notebook sdk/python/code_examples/