Metadata-Version: 2.1
Name: agentseek
Version: 0.1.0
Summary: A database-native Agent Harness for runtime data workflows, powered by Bub
Keywords: python
Author-Email: Chojan Shang <psiace@apache.org>
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Project-URL: Repository, https://github.com/ob-labs/agentseek
Requires-Python: <3.14,>=3.12
Requires-Dist: bub==0.3.9
Requires-Dist: cookiecutter>=2.5
Requires-Dist: duty>=1.9
Requires-Dist: filelock>=3.20.3
Requires-Dist: jinja2>=3.1
Requires-Dist: logfire>=4.33.0
Requires-Dist: httpx>=0.28
Requires-Dist: pydantic>=2.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

# AgentSeek

[中文](README.zh.md) | English

[![License](https://img.shields.io/github/license/ob-labs/agentseek.svg)](LICENSE)
[![CI](https://github.com/ob-labs/agentseek/actions/workflows/main.yml/badge.svg?branch=main)](https://github.com/ob-labs/agentseek/actions/workflows/main.yml?query=branch%3Amain)

AgentSeek is an application development lifecycle toolkit for AI ecosystem apps.

It helps you create a working app, check local readiness, run the development
stack, and expose project tasks through one consistent command surface.

Each template can choose its own runtime and project layout. AgentSeek provides
the shared lifecycle workflow around those generated apps.

AgentSeek 0.1.0 resolves its lifecycle-v2 templates from the immutable
[`agentseek-ai/agentseek-templates` catalog](https://github.com/agentseek-ai/agentseek-templates/releases/tag/v0.1.0).
Template listing works from the registry snapshot embedded in the CLI; named
template content is fetched at the exact locked commit.

> **"Deep Agents in Action"**: a free LangChain / DeepAgents course with AgentSeek labs.
> [Course repo](https://github.com/datawhalechina/deepagents-in-action/)

## Quickstart

Install the CLI for daily use.

```bash
uv tool install agentseek
```

For a one-off run without installing the tool, replace the first
`agentseek create ...` command with `uvx agentseek create ...`.

```bash
agentseek create bub/default --no-input
cd my_bub_agent
```

Prepare the generated project.

```bash
cp .env.example .env
$EDITOR .env
agentseek task --list
agentseek task frontend
```

Set the model and provider credentials required by the selected template in
`.env` or the environment used to run AgentSeek. AgentSeek uses `.env` only for
lifecycle environment checks declared by the template; it does not automatically
pass `.env` to child processes.
Run any additional setup tasks listed by your selected template before starting
the development stack.

```bash
agentseek doctor
agentseek dev
```

## Lifecycle Commands

| Command | Purpose |
| --- | --- |
| `create` | Render an app template. |
| `doctor` | Check local project readiness. |
| `dev` | Run the local development stack. |
| `info` | Print project entry points and lifecycle metadata. |
| `task` | Run project-defined tasks. |

For Desktop, scripts, and other machine consumers, use the versioned JSON
contract instead of parsing human output.

```bash
agentseek info --json
agentseek doctor --json
agentseek doctor --live --json
```

`info --json` includes normalized services, references, and safe actions such
as which URL can be opened directly. It never includes environment values or
raw process/task commands.

## Core Concepts

- A template creates a complete editable app.
- A lifecycle file defines how the app is checked and run.
- AgentSeek gives those lifecycle tasks a stable command interface.

Template types currently include `bub`, `deepagents`, and `langchain`. Each
template can expose the same lifecycle commands with different runtimes.

## Chat Channels

The `langchain/default` template can run its agent through Feishu or WeCom
(企业微信) gateways in addition to its AG-UI surface. Both use Bub-maintained
channel adapters; configure the channel credentials in the generated `.env`
and follow that template's channel setup instructions.

## Documentation

- [Documentation home](https://ob-labs.github.io/agentseek/)
- [Get started](https://ob-labs.github.io/agentseek/get-started/)
- [Guides](https://ob-labs.github.io/agentseek/guides/)
- [Reference](https://ob-labs.github.io/agentseek/reference/)
- [Concepts](https://ob-labs.github.io/agentseek/concepts/)

## Development

```bash
git clone https://github.com/ob-labs/agentseek.git
cd agentseek
make install
make check
make test
make docs-test
```

## License

[Apache-2.0](LICENSE)
