Metadata-Version: 2.1
Name: agentseek
Version: 0.0.4
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: 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.

> **"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
uv sync
npm install --prefix 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.

```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. |

## 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.

## 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)
