Code‑less solution for fast‑agent with Agentfile

[yeahdongcn]

Hi everyone,

I’ve created a small project called agentman (see: https://github.com/yeahdongcn/agentman). It introduces an Agentfile — a Dockerfile‑like, declarative syntax to define and configure agents for use with https://github.com/faastore/fast-agent.

With Agentfile, you can specify models, prompts, chains, tools, and workflows in a single, human‑readable file—no Python coding required.

I’d love for anyone interested to give it a try and share feedback: usability, syntax suggestions, feature requests, or general comments.

Thanks!

[evalstate]

I like the look of this... what would be involved in adding the ability to make assertions during the workflow (to do simple content testing OR looking at configured tools etc?)

[yeahdongcn]

Thanks for taking a look! These are excellent suggestions, and I’ll incorporate them into the project.

[yeahdongcn]

Just added the validation process (yeahdongcn/agentman@7f2f444):

➜ uv run agentman build ./examples/github-maintainer
╭──────────────────────────────────────────────────────────── System Information ─────────────────────────────────────────────────────────────╮
│  FastAgent Version  0.2.30                                                                                                                  │
│  Platform           Darwin                                                                                                                  │
│  Python Version     3.13.3 (main, Apr  8 2025, 13:54:08) [Clang 16                                                                          │
│  Python Path        /Users/yexiaodong/go/src/github.com/yeahdongcn/agentman/.venv/bin/python3                                               │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭──────────────────────────────────────────────────────────── Configuration Files ────────────────────────────────────────────────────────────╮
│  Secrets File      Found (/Users/yexiaodong/go/src/github.com/yeahdongcn/agentman/examples/github-maintainer/agent/fastagent.secrets.yaml)  │
│  Config File       Found (/Users/yexiaodong/go/src/github.com/yeahdongcn/agentman/examples/github-maintainer/agent/fastagent.config.yaml)   │
│  Default Model     qwen-plus                                                                                                                │
│  Logger Level      info                                                                                                                     │
│  Logger Type       console (default)                                                                                                        │
│  Progress Display  True                                                                                                                     │
│  Show Chat         True                                                                                                                     │
│  Show Tools        True                                                                                                                     │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭───────────────────────────────────────────────────────────────── API Keys ──────────────────────────────────────────────────────────────────╮
│  Provider     Env  Config  Active Key                                                                                                       │
│  Anthropic     ✗     ✗     Not configured                                                                                                   │
│  Deepseek      ✗     ✗     Not configured                                                                                                   │
│  Generic       ✗     ✗     ollama (default)                                                                                                 │
│  Googleoai     ✗     ✗     Not configured                                                                                                   │
│  Google        ✗     ✗     Not configured                                                                                                   │
│  Openai        ✓     ✗     ...Ncofs                                                                                                         │
│  Openrouter    ✗     ✗     Not configured                                                                                                   │
│  Tensorzero    ✗     ✗     Not configured                                                                                                   │
│  Azure         ✗     ✗     Not configured                                                                                                   │
│  Aliyun        ✗     ✓     ...bdc56                                                                                                         │
│  Huggingface   ✗     ✗     Not configured                                                                                                   │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭──────────────────────────────────────────────────────────────── MCP Servers ────────────────────────────────────────────────────────────────╮
│  Name               Transport  Command/URL                                                                                                  │
│  fetch              STDIO      uvx mcp-server-fetch                                                                                         │
│  git                STDIO      uvx mcp-server-git                                                                                           │
│  filesystem         STDIO      npx -y @modelcontextprotocol/server-filesystem /ws                                                           │
│  commands           STDIO      npx mcp-server-commands                                                                                      │
│  github-mcp-server  STDIO      /server/github-mcp-server stdio                                                                              │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
✅ Generated agent files in /Users/yexiaodong/go/src/github.com/yeahdongcn/agentman/examples/github-maintainer/agent/
   - agent.py
   - fastagent.config.yaml
   - fastagent.secrets.yaml
   - Dockerfile
   - requirements.txt
   - .dockerignore

[evalstate]

@jjwall

[jjwall]

This is an awesome project @yeahdongcn! And I have been working on a similar idea. I created this feature request to load in tiny agents defined in the huggingface hub #199.

I haven't got around to implementing it but it would be a good start to introduce agent loading as a fast-agent native feature. In the future I think it would be great if we could agree upon a standard DSL for defining agents like the one you introduce in agentman.

[yeahdongcn]

Thanks for checking this! Your idea looks brilliant. It might be great to collaborate on this, as both approaches seem to share some common ground.

[jjwall]

Yes! Message me on discord when you get a chance would love to chat ideas for a collaborative approach—my discord is: gizmolo

[yeahdongcn]

Unfortunately discord is not accessible in China 😂