README
¶
tapes
Transparent agentic telemetry and instrumentation for content-addressable LLM interactions.
About
·
Download
·
Documentation
·
Contributing
tapes is an Agentic telemetry system for content-addressable LLM interactions.
It provides durable storage of agent sessions, plug-and-play OpenTelemetry instrumentation,
and deterministic replay of past agent messages.
📼 Quickstart
Install tapes:
curl -fsSL https://download.tapes.dev/install | bash
Run Ollama and the tapes services. By default, tapes targets embeddings on Ollama
with the embeddinggema:latest model - pull this model with ollama pull embeddinggema:
ollama serve
tapes serve
Start a chat session:
tapes chat --model gemma3
Search conversation turns:
tapes search "What's the weather like in New York?"
Checkout a previous conversation state for context check-pointing and retry:
tapes checkout abc123xyz987
tapes chat
Directories
¶
| Path | Synopsis |
|---|---|
|
Package api provides an HTTP API server for inspecting and managing the Merkle DAG.
|
Package api provides an HTTP API server for inspecting and managing the Merkle DAG. |
|
mcp
Package mcp provides an MCP (Model Context Protocol) server for the Tapes system.
|
Package mcp provides an MCP (Model Context Protocol) server for the Tapes system. |
|
search
Package search provides shared search types and logic for semantic search over stored LLM sessions.
|
Package search provides shared search types and logic for semantic search over stored LLM sessions. |
|
cli
|
|
|
tapes
command
|
|
|
tapesapi
command
|
|
|
tapesprox
command
|
|
|
cmd
|
|
|
tapes
Package tapescmder
|
Package tapescmder |
|
tapes/chat
Package chatcmder provides the chat command for interactive LLM chat through the tapes proxy.
|
Package chatcmder provides the chat command for interactive LLM chat through the tapes proxy. |
|
tapes/checkout
Package checkoutcmder provides the checkout subcommand for checking out a point in the conversation DAG.
|
Package checkoutcmder provides the checkout subcommand for checking out a point in the conversation DAG. |
|
tapes/config
Package configcmder provides the config command for managing persistent tapes configuration stored in the .tapes/ directory.
|
Package configcmder provides the config command for managing persistent tapes configuration stored in the .tapes/ directory. |
|
tapes/deck
Package deckcmder provides the deck command for session ROI dashboards.
|
Package deckcmder provides the deck command for session ROI dashboards. |
|
tapes/init
Package initcmder provides the init command for initializing a local .tapes directory in the current working directory.
|
Package initcmder provides the init command for initializing a local .tapes directory in the current working directory. |
|
tapes/search
Package searchcmder provides the search command for semantic search over sessions.
|
Package searchcmder provides the search command for semantic search over sessions. |
|
tapes/serve
Package servecmder provides the serve command with subcommands for running services.
|
Package servecmder provides the serve command with subcommands for running services. |
|
tapes/serve/api
Package apicmder provides the API tapes server cobra command.
|
Package apicmder provides the API tapes server cobra command. |
|
tapes/serve/proxy
Package proxycmder provides the proxy server command.
|
Package proxycmder provides the proxy server command. |
|
tapes/status
Package statuscmder provides the status command for displaying the current checkout state of the local .tapes directory.
|
Package statuscmder provides the status command for displaying the current checkout state of the local .tapes directory. |
|
version
Package versioncmder
|
Package versioncmder |
|
pkg
|
|
|
dotdir
Package dotdir manages the .tapes/ and ~/.tapes directories.
|
Package dotdir manages the .tapes/ and ~/.tapes directories. |
|
embeddings
Package embeddings
|
Package embeddings |
|
embeddings/ollama
Package ollama implements pkg/embedding's Embedder client for Ollama's embedding APIs
|
Package ollama implements pkg/embedding's Embedder client for Ollama's embedding APIs |
|
embeddings/utils
Package embeddingutils is the embeddings utility package
|
Package embeddingutils is the embeddings utility package |
|
llm
Package llm provides a internal representations of LLM inference API requests and responses which are then further mutated and handled.
|
Package llm provides a internal representations of LLM inference API requests and responses which are then further mutated and handled. |
|
llm/provider/anthropic
Package anthropic
|
Package anthropic |
|
llm/provider/ollama
Package ollama
|
Package ollama |
|
llm/provider/openai
Package openai
|
Package openai |
|
logger
Package logger provides opinionated logging capabilities for the tapes system
|
Package logger provides opinionated logging capabilities for the tapes system |
|
merkle
Package merkle is an implementation of a Merkel DAG
|
Package merkle is an implementation of a Merkel DAG |
|
storage
Package storage
|
Package storage |
|
storage/ent/driver
Package entdriver
|
Package entdriver |
|
storage/sqlite
Package sqlite provides a SQLite-backed storage driver using ent ORM.
|
Package sqlite provides a SQLite-backed storage driver using ent ORM. |
|
utils
Package utils provides bespoke, one off utils that don't make sense to be their own package
|
Package utils provides bespoke, one off utils that don't make sense to be their own package |
|
vector
Package vector provides interfaces and implementations for vector storage and embedding.
|
Package vector provides interfaces and implementations for vector storage and embedding. |
|
vector/chroma
Package chroma provides a Chroma vector database driver implementation.
|
Package chroma provides a Chroma vector database driver implementation. |
|
vector/sqlitevec
Package sqlitevec provides a SQLite-backed vector driver using sqlite-vec.
|
Package sqlitevec provides a SQLite-backed vector driver using sqlite-vec. |
|
Package proxy provides an LLM inference proxy that stores conversations in a Merkle DAG.
|
Package proxy provides an LLM inference proxy that stores conversations in a Merkle DAG. |
|
header
Package header provides header filtering for the tapes proxy.
|
Package header provides header filtering for the tapes proxy. |
|
worker
Package worker provides an asynchronous worker pool and utils for persisting conversation turns using the provided storage.Driver and generating embeddings using the provided embeddings.Embedder.
|
Package worker provides an asynchronous worker pool and utils for persisting conversation turns using the provided storage.Driver and generating embeddings using the provided embeddings.Embedder. |
|
web
|
|
Click to show internal directories.
Click to hide internal directories.