Skip to content
Back to search

agentseek

AgentSeek is an application development lifecycle toolkit for AI ecosystem apps, built by OceanBase OSS Team.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ob-labs--agentseek/badge.svg)](/listings/ob-labs--agentseek)

HTML

<a href="/listings/ob-labs--agentseek"><img src="/api/listings/ob-labs--agentseek/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 224 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <h1>AgentSeek</h1>
  3. <p><strong>Discover · Create · Run · Observe · Iterate</strong></p>
  4. <p>
  5. <a href="https://github.com/ob-labs/agentseek/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/ob-labs/agentseek?style=flat-square&logo=github" /></a>
  6. <a href="https://github.com/ob-labs/agentseek/releases"><img alt="GitHub release" src="https://img.shields.io/github/v/release/ob-labs/agentseek?style=flat-square" /></a>
  7. <a href="https://pypi.org/project/agentseek/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentseek?style=flat-square&logo=pypi" /></a>
  8. <a href="https://pypi.org/project/agentseek/"><img alt="Python versions" src="https://img.shields.io/pypi/pyversions/agentseek?style=flat-square&logo=python" /></a>
  9. <a href="https://github.com/ob-labs/agentseek/actions/workflows/main.yml?query=branch%3Amain"><img alt="Build status" src="https://img.shields.io/github/actions/workflow/status/ob-labs/agentseek/main.yml?branch=main&style=flat-square&label=CI" /></a>
  10. <br />
  11. <a href="https://github.com/ob-labs/agentseek/graphs/contributors"><img alt="Contributors" src="https://img.shields.io/github/contributors/ob-labs/agentseek?style=flat-square" /></a>
  12. <a href="https://github.com/ob-labs/agentseek/issues"><img alt="Open issues" src="https://img.shields.io/github/issues/ob-labs/agentseek?style=flat-square" /></a>
  13. <a href="https://github.com/ob-labs/agentseek/blob/HEAD/LICENSE"><img alt="License" src="https://img.shields.io/github/license/ob-labs/agentseek?style=flat-square" /></a>
  14. <a href="https://ob-labs.github.io/agentseek/"><img alt="Documentation" src="https://img.shields.io/badge/docs-AgentSeek-0ea5e9?style=flat-square" /></a>
  15. </p>
  16. <p>Template-first tooling for editable local agent applications and their complete development lifecycle.</p>
  17. <p><a href="README.md">English</a> · <a href="README.zh.md">中文</a></p>
  18. [Experience the local ADLC](#experience-adlc) · [What is AgentSeek?](#what-is-agentseek) · [Lifecycle](#agent-development-lifecycle) · [Guided templates](#guided-templates) · [Community](#community)
  19. [Development](#development)
  20. <p>⭐ <a href="https://github.com/ob-labs/agentseek/stargazers">Star AgentSeek to follow its progress.</a></p>
  21. <hr />
  22. </div>
  23. AgentSeek is a template-first toolkit for local agent application development.
  24. It gives editable generated projects one predictable lifecycle: discover,
  25. create, inspect, configure, check, run, observe, and iterate.
  26. AgentSeek 0.1.6 resolves lifecycle-v2 templates from the immutable
  27. [`agentseek-ai/agentseek-templates` catalog](https://github.com/agentseek-ai/agentseek-templates/tree/v0.1.7).
  28. The CLI lists templates from its embedded registry snapshot and fetches named
  29. template content at the exact locked commit.
  30. <a id="experience-adlc"></a>
  31. ## Experience the local ADLC
  32. Start with the shipped `deepagents/research` walkthrough. It creates a fully
  33. editable DeepAgents research app with a native LangGraph backend and a React frontend
  34. as its primary user experience.
  35. ```bash
  36. # Install the lifecycle CLI, then create and enter the generated project.
  37. uv tool install agentseek
  38. agentseek create deepagents/research --no-input
  39. cd research_deepagent
  40. # Inspect declared entry points before configuring local credentials.
  41. agentseek info
  42. cp .env.example .env
  43. cp frontend/.env.example frontend/.env
  44. $EDITOR .env
  45. # Run the setup tasks declared by this project, then check readiness.
  46. agentseek task --list
  47. agentseek task sync
  48. agentseek task frontend
  49. agentseek doctor
  50. # Preview the native commands, run the local stack, and check live services.
  51. agentseek dev --dry-run
  52. agentseek dev
  53. # In another terminal, after agentseek dev starts, check live services.
  54. agentseek doctor --live
  55. ```
  56. The current scaffold declares only `sync` and `frontend` setup tasks. Its
  57. native backend resolves to `uv run langgraph dev --port 2024 --no-browser`,
  58. while the frontend resolves to `npm run dev` in `frontend/`.
  59. For a one-off run, use `uvx agentseek create deepagents/research --no-input`
  60. instead of installing the CLI.
  61. <a id="what-is-agentseek"></a>
  62. ## What is AgentSeek?
  63. AgentSeek supplies the stable lifecycle surface around a generated project; it
  64. does not own that project's source, framework, runtime, or deployment. A
  65. template selects those pieces, and the generated project remains yours to edit.
  66. ![AgentSeek architecture](https://raw.githubusercontent.com/ob-labs/agentseek/v0.1.1/diagram/agentseek-readme/agentseek-architecture-en.svg)
  67. The CLI connects people, coding agents, and desktop clients to a locked,
  68. versioned template catalog and an editable project lifecycle contract. The
  69. project then owns its runtimes and integrations, including models, tools, MCP
  70. servers, and external services.
  71. <a id="agent-development-lifecycle"></a>
  72. ## Agent Development Lifecycle
  73. The local ADLC keeps iteration anchored in the existing project instead of
  74. starting over: discover, create, inspect, configure, check, run, observe, and
  75. iterate back to inspect.
  76. ![Agent development lifecycle](https://raw.githubusercontent.com/ob-labs/agentseek/v0.1.1/diagram/agentseek-readme/agentseek-adlc-en.svg)
  77. | Stage | Local command or project surface |
  78. | --- | --- |
  79. | Discover | `agentseek create --list-templates` finds templates by goal. |
  80. | Create | `agentseek create` renders an editable project. |
  81. | Inspect | `agentseek info` shows its declared entry points and topology. |
  82. | Configure | `.env` and project configuration provide runtime credentials and choices. |
  83. | Check | `agentseek doctor` validates local readiness. |
  84. | Run | `agentseek dev` starts the template-owned local stack. |
  85. | Observe | `agentseek doctor --live` and lifecycle signals show its current state. |
  86. | Iterate | Change the generated project, then return to **Inspect**. |
  87. ## Observability throughout the loop
  88. Lifecycle diagnostics answer whether the declared project is ready and running:
  89. `agentseek info` shows topology, `agentseek doctor` performs preflight checks,
  90. and `agentseek doctor --live` checks declared services after startup. For
  91. Desktop, scripts, and other machine consumers, use the versioned JSON contract
  92. instead of parsing human output.
  93. ```bash
  94. agentseek info --json
  95. agentseek doctor --json
  96. agentseek doctor --live --json
  97. AGENTSEEK_CONSOLE=true agentseek doctor --live
  98. ```
  99. `info --json` contains normalized services, references, and safe actions such
  100. as which URL can be opened directly. It never includes environment values or
  101. raw process or task commands. `AGENTSEEK_CONSOLE=true` enables local CLI spans
  102. and lifecycle events. Optional LangSmith tracing, configured through the
  103. settings already present in `deepagents/research`, answers what the agent did
  104. inside an individual run. When your LangSmith API key belongs to the APAC or
  105. another non-default region, set `LANGSMITH_ENDPOINT` explicitly (for example
  106. `https://apac.api.smith.langchain.com`); otherwise traces may fail to upload
  107. to the cloud. See the [observability and tracing guide](docs/guides/observability-tracing.md) for setup and troubleshooting.
  108. <a id="guided-templates"></a>
  109. ## Guided templates
  110. Choose by goal, then inspect a specific template before creating it. AgentSeek
  111. maintains many templates without requiring you to memorize a catalog dump.
  112. ```bash
  113. agentseek create --list-templates
  114. agentseek create --list-templates --filter deepagents
  115. agentseek create deepagents/research --describe
  116. ```
  117. ## Core concepts and commands
  118. | Concept | What it provides |
  119. | --- | --- |
  120. | Template | A complete, editable application scaffold with its chosen runtime. |
  121. | Lifecycle file | The project-owned declaration of paths, environment checks, services, processes, and tasks. |
  122. | AgentSeek CLI | A consistent local interface for the declared lifecycle. |
  123. | Command | Purpose |
  124. | --- | --- |
  125. | `create` | Render an application template. |
  126. | `info` | Show declared entry points and lifecycle metadata. |
  127. | `task` | Run a project-defined setup task. |
  128. | `doctor` | Check local readiness or live declared-service health. |
  129. | `dev` | Run the local development stack. |
  130. ## Documentation
  131. - [Documentation home](https://ob-labs.github.io/agentseek/)
  132. - [Get started](https://ob-labs.github.io/agentseek/get-started/)
  133. - [Guides](https://ob-labs.github.io/agentseek/guides/)
  134. - [Reference](https://ob-labs.github.io/agentseek/reference/)
  135. - [Concepts](https://ob-labs.github.io/agentseek/concepts/)
  136. <a id="community"></a>
  137. ## 🌐 Next Steps & Community
  138. Explore **Deep Agents in Action**, a free LangChain / DeepAgents course with
  139. AgentSeek labs, in the [course repository](https://github.com/datawhalechina/deepagents-in-action/).
  140. Read the [documentation](https://ob-labs.github.io/agentseek/), join
  141. [GitHub Discussions](https://github.com/ob-labs/agentseek/discussions),
  142. [browse or report an issue](https://github.com/ob-labs/agentseek/issues), or
  143. follow the [contribution guide](https://github.com/ob-labs/agentseek/blob/HEAD/CONTRIBUTING.md).
  144. <div align="center">
  145. <a href="https://github.com/ob-labs/agentseek/discussions"><img alt="GitHub Discussions" src="https://img.shields.io/badge/GitHub-Discussions-181717?style=for-the-badge&logo=github" /></a>
  146. <a href="https://github.com/ob-labs/agentseek/blob/HEAD/CONTRIBUTING.md"><img alt="Contribute to AgentSeek" src="https://img.shields.io/badge/Contribute-AgentSeek-0ea5e9?style=for-the-badge" /></a>
  147. </div>
  148. ---
  149. <a id="development"></a>
  150. ## 🛠️ Development
  151. ```bash
  152. git clone https://github.com/ob-labs/agentseek.git
  153. cd agentseek
  154. make install
  155. make check
  156. make test
  157. make docs-test
  158. ```
  159. ### Contributing
  160. Contributions, fixes, and template improvements are welcome.
  161. <div align="center">
  162. <a href="https://github.com/ob-labs/agentseek/graphs/contributors"><img alt="AgentSeek contributors" src="https://contrib.rocks/image?repo=ob-labs/agentseek&max=400" /></a>
  163. </div>
  164. ---
  165. ## 📄 License
  166. [Apache-2.0](https://github.com/ob-labs/agentseek/blob/HEAD/LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.