Skip to content

ob-labs/agentseek

Repository files navigation

AgentSeek

中文 | English

License CI

A database-native Agent Harness by the OceanBase OSS Team.

AgentSeek helps teams turn agent runtime data into a database workload: turns, context, tool calls, tasks, feedback, checkpoints, memory, and observability stay queryable instead of being scattered across logs and side systems.

It is built for teams that want to move from a local LangChain, DeepAgents, or Bub prototype to a maintainable agent application with a clear runtime, storage, context, and serving story.

"Deep Agents 实战": a free LangChain / DeepAgents course with AgentSeek labs. Course site · Source repo

Quick Start

Goal Commands Use it when
Manage projects agentseek create/run/build/deploy You want to scaffold, run, package, or deploy an application.
Run the harness agentseek chat/turn/gateway You want to evaluate, embed, or operate the runtime.
Extend the runtime agentseek plugin/ctx/skills/api You want plugins, context, skills, or service bridges.

Create a template project

uv tool install agentseek
agentseek create --list-templates
agentseek create langchain/markdown-messages
cd markdown_messages_agent
cp .env.example .env
uv sync
uv run langgraph dev

Use this path when you want a generated application scaffold. Templates cover LangChain, DeepAgents, and lightweight starters.

Run the harness

agentseek chat

Use this path when you want the harness runtime directly: a chat loop, gateway, plugins, MCP, or an embeddable Python package.

For all commands and options, see the CLI reference.

Repository Overview

Component Role
agentseek CLI, harness runtime, project commands, and embeddable library.
templates/ Cookiecutter starters for common application shapes.
contrib/ Optional integrations for frameworks, storage, and context systems.

Related projects:

Project Role
agentseek-api Agent Protocol server for production LangGraph serving.
ContextSeek Semantic memory, retrieval, evolution, HTTP API, MCP, and LangChain middleware.
langchain-oceanbase LangGraph checkpoint, store, vector search, and hybrid search on OceanBase, seekdb, or MySQL.

AgentSeek also builds on Bub, a hook-first agent runtime and framework.

Typical Workflow

The usual flow is:

  1. Create a project when you need an application scaffold.
  2. Run AgentSeek itself when you need the harness runtime.
  3. Add durable runtime data through the harness and storage integrations.
  4. Add semantic memory with ContextSeek when the agent needs cross-session context.
  5. Serve production LangGraph apps through agentseek-api.

Storage, memory, and serving are added only when the application needs them.

Template Choices

Pick the smallest template that matches your application:

Application shape Start with
Minimal LangChain app agentseek create langchain/markdown-messages
Full AgentSeek delivery app agentseek create langchain/default
DeepAgents research app agentseek create deepagents/research
Lightweight app without LangChain agentseek create bub/default

See Templates reference for the full catalogue.

Documentation

Useful package docs in this repo:

Development

make install
make check
make test
make docs-test

License

Apache-2.0