Skip to main content

AgentSeek

中文 | English

License CI

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.

AgentSeek architecture

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.

Agent development lifecycle

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

Apache-2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentseek-0.1.1.tar.gz (1.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentseek-0.1.1-py3-none-any.whl (112.1 kB view details)

Uploaded Python 3

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

Hashes for agentseek-0.1.1.tar.gz
Algorithm Hash digest
SHA256 2d669930e4a8cd0953625c9757b48d90f238f3d61d16d1be8af7d4d07afa8507
MD5 a863dbd479836e670e822c27ce180f20
BLAKE2b-256 61c46c5f313853dea1ba6b281cd744164036aaea8087276a809e67b49b6305ca

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentseek-0.1.1.tar.gz:

Publisher: on-release-main.yml on ob-labs/agentseek

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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

Hashes for agentseek-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4b66ac6b30e6057fd1bb216600333d9a33a9e1ef419df6e4b108f5e42c525224
MD5 6ea1d0690f56696024c12f83ae66ca12
BLAKE2b-256 105cab8267f950986d99b9173302415eaa632b2cc4fb454321b2670d4c32e2bd

See more details on using hashes here.

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

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page