Overview

SHIPIT Agent is a standalone Python agent library focused on a clean, production-grade runtime:

• Bring your own LLM — or use any of nine built-in provider adapters (OpenAI, Anthropic, Bedrock, Gemini, Vertex, Groq, Together, Ollama, LiteLLM)
• Tools, MCP, connectors — Python tools, remote MCP servers, 18 SaaS connectors (Gmail, Drive, Slack, GitHub, GitLab, Linear, Jira, Notion, Confluence, Salesforce, Stripe, Figma, Sheets, Zendesk, LinkedIn, PDF, SQL, custom HTTP APIs)
• Five flagship power features (v1.0.8) — structured output with auto-retry, verifier network, memory consolidation, time-travel replay, computer-use agent
• Skills marketplace — packaged or custom skills steer agent behavior and reusable workflows
• Streaming events — including reasoning / thinking blocks as they happen
• Tracing — file-based, OpenTelemetry, or LangSmith out of the box
• Cost tracking + budgets — every LLM call accounted; hard caps per run
• Autopilot — 24-hour budget-gated runs that survive crashes via JSON checkpoints
• Multi-agent — Supervisor/Worker pattern, AgentTeam orchestration, sub-agent delegation
• DeepAgent — power-user wrapper with verify / reflect / goal / RAG layers

Built for developers building real production agents — agents that beat ChatGPT and Operator on observability, cost control, self-hosting, and breadth of integration. Library-level API the whole way down.

Install

pip install shipit-agent

With optional extras:

pip install 'shipit-agent[openai]'         # OpenAI SDK
pip install 'shipit-agent[anthropic]'      # Anthropic SDK (native thinking blocks)
pip install 'shipit-agent[litellm]'        # LiteLLM (Bedrock, Gemini, Groq, Together, …)
pip install 'shipit-agent[playwright]'     # In-process browser for open_url and web_search
pip install 'shipit-agent[all]'            # Everything

30-second example

from shipit_agent import Agent
from shipit_agent.llms import OpenAIChatLLM

agent = Agent.with_builtins(llm=OpenAIChatLLM(model="gpt-4o-mini"))

for event in agent.stream("Search the web for today's Bitcoin price in USD."):
    print(event.type, event.message)

Works with any provider — swap OpenAIChatLLM for AnthropicChatLLM, BedrockChatLLM, VertexAIChatLLM, GeminiChatLLM, GroqChatLLM, TogetherChatLLM, OllamaChatLLM, or LiteLLMChatLLM, or use build_llm_from_env() to pick from .env. The agent code never changes. See LLM providers — use any model.

Emits events like:

run_started           Agent run started
step_started          LLM completion started
reasoning_started     🧠 Model reasoning started
reasoning_completed   🧠 Model reasoning completed
tool_called           Tool called: web_search
tool_completed        Tool completed: web_search
run_completed         Agent run completed

Power features (v1.0.8)

Five flagship capabilities, all reachable from from shipit_agent import …, all available on both Agent AND DeepAgent.

+337 unit tests · 1527 passing · 0 regressions — every feature is reachable from a single from shipit_agent import … and works on both Agent and DeepAgent.

Why SHIPIT Agent

Next steps

• Install and run the quick start — get an agent running in five minutes
• Explore streaming events — understand the 14 event types and what they carry
• Reasoning and thinking steps — render a live "Thinking" panel in your UI
• Create a custom tool — build a new tool from scratch
• Use skills — packaged skills, custom skills, Agent, and DeepAgent workflows
• MCP integration — attach remote MCP servers to extend capabilities
• Parallel tool execution — speed up multi-tool turns
• Hooks & middleware — add cost tracking, logging, and guardrails
• Async runtime — use with FastAPI and async Python
• Context window management — track tokens and manage context limits
• Error recovery — graceful failure handling and retry policies

Try it now — runnable examples

The repo ships with 7 numbered, copy-pasteable examples covering every major feature. Pick one and run it in 30 seconds.

See the full examples README →

Provider compatibility matrix

Tip: if you want a "Thinking" panel UI without paying for o1/Claude, AWS Bedrock's openai.gpt-oss-120b-1:0 is the cheapest reasoning-capable model in the matrix and ships with Agent.with_builtins(llm=BedrockChatLLM()) out of the box.

What you get vs. what you don't

This is a library, not a framework. The runtime is small enough to read in one sitting (shipit_agent/runtime.py is under 400 lines). Bring your own LLM, tools, and storage; the runtime composes them and gets out of the way.