Metadata-Version: 2.4
Name: gentleman-agents
Version: 0.1.1
Summary: Declarative AI agent server — MCP for tools, A2A for agents, AG-UI for humans
Keywords: ai,agents,agent-server,llm,pydantic-ai,mcp,a2a,ag-ui
Author: masafumi-sasahara
Author-email: masafumi-sasahara <masafumi@sasahara.io>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: OS Independent
Classifier: Framework :: FastAPI
Classifier: Environment :: Web Environment
Classifier: Topic :: Software Development :: Libraries
Classifier: Typing :: Typed
Requires-Dist: a2a-sdk>=0.3,<1
Requires-Dist: fasta2a[pydantic-ai]>=0.6.1,<0.7
Requires-Dist: fastapi>=0.139.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: pydantic-ai-slim[ag-ui,anthropic,bedrock,mcp,openai,spec]>=2.10.0
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: uvicorn>=0.51.0
Requires-Dist: gentleman-agents[chat] ; extra == 'all'
Requires-Dist: prompt-toolkit>=3.0.52 ; extra == 'chat'
Requires-Dist: rich>=15.0.0 ; extra == 'chat'
Requires-Python: >=3.14
Project-URL: Homepage, https://github.com/madebyman/gentleman
Project-URL: Repository, https://github.com/madebyman/gentleman
Project-URL: Issues, https://github.com/madebyman/gentleman/issues
Provides-Extra: all
Provides-Extra: chat
Description-Content-Type: text/markdown

# Gentleman

*A gentleman among agents.*

Declarative AI agent server — MCP for tools, A2A for agents, AG-UI for humans.

## Requirements

- Python 3.14+

## Quick start

Run without installing, using [uv](https://docs.astral.sh/uv/):

```sh
uvx --from gentleman-agents gentleman init my-agents
```

`gentleman init` scaffolds a project into the given directory, creating it if it
does not exist. Without an argument, it scaffolds into the current directory.

The package is published as `gentleman-agents`, while the command is `gentleman`.
The `--from` flag is therefore required with `uvx`.

## Install

As a command-line tool:

```sh
uv tool install gentleman-agents
gentleman --help
```

As a project dependency:

```sh
uv add gentleman-agents
```

With pip:

```sh
pip install gentleman-agents
```

## Interactive chat

The `gentleman chat` subcommand needs the `chat` extra:

```sh
uv tool install "gentleman-agents[chat]"
gentleman chat
```

Or run it directly:

```sh
uvx --from "gentleman-agents[chat]" gentleman chat
```

To add it to a project instead:

```sh
uv add "gentleman-agents[chat]"
```

## Docker

Images are published to the GitHub Container Registry for `linux/amd64` and
`linux/arm64`:

```sh
docker pull ghcr.io/madebyman/gentleman:edge
```

`edge` tracks the latest build from `main`. See the
[packages page](https://github.com/madebyman/gentleman/pkgs/container/gentleman)
for available tags.

## Status

Alpha. The API and the configuration format may change without notice.

## License

MIT
