AgentSeek
中文 | English
AgentSeek is a template-first toolkit for local agent application development. It gives editable generated projects one predictable lifecycle: discover, create, inspect, configure, check, run, observe, and iterate.
AgentSeek 0.1.1 resolves lifecycle-v2 templates from the immutable
agentseek-ai/agentseek-templates catalog.
The CLI lists templates from its embedded registry snapshot and fetches named
template content at the exact locked commit.
Experience the local ADLC
Start with the shipped deepagents/research walkthrough. It creates a fully
editable DeepAgents research app with a native LangGraph backend and a React frontend
as its primary user experience.
# Install the lifecycle CLI, then create and enter the generated project.
uv tool install agentseek
agentseek create deepagents/research --no-input
cd research_deepagent
# Inspect declared entry points before configuring local credentials.
agentseek info
cp .env.example .env
cp frontend/.env.example frontend/.env
$EDITOR .env
# Run the setup tasks declared by this project, then check readiness.
agentseek task --list
agentseek task sync
agentseek task frontend
agentseek doctor
# Preview the native commands, run the local stack, and check live services.
agentseek dev --dry-run
agentseek dev
# In another terminal, after agentseek dev starts, check live services.
agentseek doctor --live
The current scaffold declares only sync and frontend setup tasks. Its
native backend resolves to uv run langgraph dev --port 2024 --no-browser,
while the frontend resolves to npm run dev in frontend/.
For a one-off run, use uvx agentseek create deepagents/research --no-input
instead of installing the CLI.
What is AgentSeek?
AgentSeek supplies the stable lifecycle surface around a generated project; it does not own that project's source, framework, runtime, or deployment. A template selects those pieces, and the generated project remains yours to edit.
The CLI connects people, coding agents, and desktop clients to a locked, versioned template catalog and an editable project lifecycle contract. The project then owns its runtimes and integrations, including models, tools, MCP servers, and external services.
Agent Development Lifecycle
The local ADLC keeps iteration anchored in the existing project instead of starting over: discover, create, inspect, configure, check, run, observe, and iterate back to inspect.
| Stage | Local command or project surface |
|---|---|
| Discover | agentseek create --list-templates finds templates by goal. |
| Create | agentseek create renders an editable project. |
| Inspect | agentseek info shows its declared entry points and topology. |
| Configure | .env and project configuration provide runtime credentials and choices. |
| Check | agentseek doctor validates local readiness. |
| Run | agentseek dev starts the template-owned local stack. |
| Observe | agentseek doctor --live and lifecycle signals show its current state. |
| Iterate | Change the generated project, then return to Inspect. |
Observability throughout the loop
Lifecycle diagnostics answer whether the declared project is ready and running:
agentseek info shows topology, agentseek doctor performs preflight checks,
and agentseek doctor --live checks declared services after startup. For
Desktop, scripts, and other machine consumers, use the versioned JSON contract
instead of parsing human output.
agentseek info --json
agentseek doctor --json
agentseek doctor --live --json
AGENTSEEK_CONSOLE=true agentseek doctor --live
info --json contains normalized services, references, and safe actions such
as which URL can be opened directly. It never includes environment values or
raw process or task commands. AGENTSEEK_CONSOLE=true enables local CLI spans
and lifecycle events. Optional LangSmith tracing, configured through the
settings already present in deepagents/research, answers what the agent did
inside an individual run.
Guided templates
Choose by goal, then inspect a specific template before creating it. AgentSeek maintains many templates without requiring you to memorize a catalog dump.
agentseek create --list-templates
agentseek create --list-templates --filter deepagents
agentseek create deepagents/research --describe
Core concepts and commands
| Concept | What it provides |
|---|---|
| Template | A complete, editable application scaffold with its chosen runtime. |
| Lifecycle file | The project-owned declaration of paths, environment checks, services, processes, and tasks. |
| AgentSeek CLI | A consistent local interface for the declared lifecycle. |
| Command | Purpose |
|---|---|
create |
Render an application template. |
info |
Show declared entry points and lifecycle metadata. |
task |
Run a project-defined setup task. |
doctor |
Check local readiness or live declared-service health. |
dev |
Run the local development stack. |
Documentation
Development
git clone https://github.com/ob-labs/agentseek.git
cd agentseek
make install
make check
make test
make docs-test
Community and course
Explore Deep Agents in Action, a free LangChain / DeepAgents course with AgentSeek labs, in the course repository. Join or follow project discussion through GitHub Discussions.
License
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agentseek-0.1.1.tar.gz.
File metadata
- Download URL: agentseek-0.1.1.tar.gz
- Upload date:
- Size: 1.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2d669930e4a8cd0953625c9757b48d90f238f3d61d16d1be8af7d4d07afa8507
|
|
| MD5 |
a863dbd479836e670e822c27ce180f20
|
|
| BLAKE2b-256 |
61c46c5f313853dea1ba6b281cd744164036aaea8087276a809e67b49b6305ca
|
Provenance
The following attestation bundles were made for agentseek-0.1.1.tar.gz:
Publisher:
on-release-main.yml on ob-labs/agentseek
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
agentseek-0.1.1.tar.gz -
Subject digest:
2d669930e4a8cd0953625c9757b48d90f238f3d61d16d1be8af7d4d07afa8507 - Sigstore transparency entry: 2289372192
- Sigstore integration time:
-
Permalink:
ob-labs/agentseek@2d91d5e8ab1b8eabae74c95057a5a0139e9b4abc -
Branch / Tag:
refs/tags/v0.1.1 - Owner: https://github.com/ob-labs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
on-release-main.yml@2d91d5e8ab1b8eabae74c95057a5a0139e9b4abc -
Trigger Event:
push
-
Statement type:
File details
Details for the file agentseek-0.1.1-py3-none-any.whl.
File metadata
- Download URL: agentseek-0.1.1-py3-none-any.whl
- Upload date:
- Size: 112.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b66ac6b30e6057fd1bb216600333d9a33a9e1ef419df6e4b108f5e42c525224
|
|
| MD5 |
6ea1d0690f56696024c12f83ae66ca12
|
|
| BLAKE2b-256 |
105cab8267f950986d99b9173302415eaa632b2cc4fb454321b2670d4c32e2bd
|
Provenance
The following attestation bundles were made for agentseek-0.1.1-py3-none-any.whl:
Publisher:
on-release-main.yml on ob-labs/agentseek
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
agentseek-0.1.1-py3-none-any.whl -
Subject digest:
4b66ac6b30e6057fd1bb216600333d9a33a9e1ef419df6e4b108f5e42c525224 - Sigstore transparency entry: 2289372235
- Sigstore integration time:
-
Permalink:
ob-labs/agentseek@2d91d5e8ab1b8eabae74c95057a5a0139e9b4abc -
Branch / Tag:
refs/tags/v0.1.1 - Owner: https://github.com/ob-labs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
on-release-main.yml@2d91d5e8ab1b8eabae74c95057a5a0139e9b4abc -
Trigger Event:
push
-
Statement type: