tine 0.1.1

Python wrapper and MCP package for the Tine runtime

Tine

A branching notebook runtime for AI and humans.

Tine is a local-first execution engine where notebooks branch like code. Run work in the browser, connect an agent through MCP, and keep both attached to the same fast local runtime.

Tine gives AI agents a safe place to explore multiple paths in parallel while you keep the browser view over the same local state, logs, and results.

What Tine is

Tine is built around a tree-native notebook model:

• an experiment is the main working unit
• an experiment contains branches
• branches contain cells

Each experiment owns its own execution environment and kernel. Execution happens against branches and cells inside that experiment, which makes it practical to explore multiple paths without collapsing everything into one linear notebook.

In practice, that gives Tine a few important properties:

• local-first execution
• branch-aware notebook workflows
• reproducible runtime ownership
• one backend shared by the UI and MCP

Product shape

Tine has a simple surface model:

• Web UI for people
• Local Rust server as the canonical backend
• Python MCP layer for agent integrations

The UI and MCP are adapters over the same local system rather than separate runtimes.

Quick start

The release-oriented install path is:

pip install tine

Then start the local server for your workspace:

tine serve --workspace . --bind 127.0.0.1:9473 --open

If you want to sanity-check the install first:

tine doctor

Open the app at:

http://127.0.0.1:9473

That install gives you:

• tine as the public wrapper entrypoint
• tine mcp ... for MCP config and stdio adapter commands
• tine-mcp as a compatibility alias for the MCP adapter

On first use, the wrapper resolves a matching Tine engine binary for your OS and architecture.

Supported release targets today:

OS	Architectures
macOS	Apple Silicon, Intel
Linux	x86_64, arm64
Windows	x86_64

The server is the canonical local backend. Both the web UI and MCP connect to that same API.

If you do not want the browser to open automatically:

tine serve --workspace . --bind 127.0.0.1:9473

MCP setup

Tine supports agent workflows through MCP.

The intended flow is:

1. start the local Tine server
2. configure a host to launch tine mcp serve
3. let the MCP adapter talk to the same local API used by the UI

The standard MCP stdio command is:

tine mcp serve --api-url http://127.0.0.1:9473

tine-mcp --api-url http://127.0.0.1:9473 is also supported, but tine mcp serve is the preferred public form.

MCP config generation

Generate an MCP config document for a supported host:

tine mcp print-config --host vscode

Supported hosts:

• vscode
• cursor
• claude
• generic

If your Tine server uses a non-default API URL, include it explicitly:

tine mcp print-config --host vscode --api-url http://127.0.0.1:9473

Example VS Code config output:

{
  "servers": {
    "tine": {
      "type": "stdio",
      "command": "tine",
      "args": ["mcp", "serve", "--api-url", "http://127.0.0.1:9473"]
    }
  }
}

Example Claude Desktop config output:

{
  "mcpServers": {
    "tine": {
      "command": "tine",
      "args": ["mcp", "serve", "--api-url", "http://127.0.0.1:9473"]
    }
  }
}

MCP config registration

To write the generated config directly into the standard host config location:

tine mcp register --host vscode --api-url http://127.0.0.1:9473

Equivalent examples:

tine mcp register --host cursor --api-url http://127.0.0.1:9473
tine mcp register --host claude --api-url http://127.0.0.1:9473

Default config targets are resolved per OS:

Host	macOS	Linux	Windows
VS Code	~/Library/Application Support/Code/User/mcp.json	~/.config/Code/User/mcp.json	%APPDATA%/Code/User/mcp.json
Cursor	~/Library/Application Support/Cursor/User/mcp.json	~/.config/Cursor/User/mcp.json	%APPDATA%/Cursor/User/mcp.json
Claude	~/Library/Application Support/Claude/claude_desktop_config.json	~/.config/Claude/claude_desktop_config.json	%APPDATA%/Claude/claude_desktop_config.json

If you prefer to manage the file yourself, print the config and copy it into your host config manually instead of using register.

Common local setup

For the most common local setup:

pip install tine
tine serve --workspace . --bind 127.0.0.1:9473 --open
tine mcp register --host vscode --api-url http://127.0.0.1:9473

That gives you:

• the web UI talking to the local API
• the MCP adapter talking to the same local API
• one local Rust backend shared by both

Deployment model

Tine is optimized for a deployment model that is:

• local-first
• web-first
• OS-agnostic
• agent-friendly

That means:

• no hosted service is required for the core product
• the browser UI works across platforms
• MCP exposes the same capabilities to AI tools
• deployment can focus on shipping a local server binary plus web UI

For v1, the main product promise is a local server with a browser UI and MCP on top of the same backend. The goal is not to promise multiple independent runtimes or a broad public SDK surface too early.

Development from source

If you are working inside this repository rather than using the release package, the development startup path is:

cargo run -p tine-cli -- serve --workspace . --bind 127.0.0.1:9473 --open

That path is for repo development. For fresh user onboarding and release usage, prefer pip install tine followed by tine serve.

Repository guide

If you are navigating the repo, these are the most relevant top-level areas:

• ui/ for the browser UI
• crates/tine-server/ for the local HTTP and WebSocket server
• crates/tine-cli/ for the local launcher and operator commands
• packaging/python/ for the Python wrapper, packaging, and MCP entrypoints

Acknowledgements

Tine is grateful to the ipykernel and Jupyter communities. Their work helped establish the notebook and kernel patterns that make interactive computing and tool-driven workflows possible.