Skip to content

A cookiecutter template for Python agent projects that use uv for dependency management

License

Notifications You must be signed in to change notification settings

GetBindu/create-bindu-agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

93 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

bindu Logo

Create Bindu Agent ๐ŸŒป

"We imagine a world of agents where they can communicate with each other seamlessly.
And Bindu turns your agent into a living server, the dot (Bindu) in the Internet of Agents."

๐Ÿ‡ฌ๐Ÿ‡ง English โ€ข ๐Ÿ‡จ๐Ÿ‡ณ ็ฎ€ไฝ“ไธญๆ–‡ โ€ข ๐Ÿ‡ช๐Ÿ‡ธ Espaรฑol โ€ข ๐Ÿ‡ซ๐Ÿ‡ท Franรงais โ€ข ๐Ÿ‡ฏ๐Ÿ‡ต ๆ—ฅๆœฌ่ชž โ€ข ๐Ÿ‡ฎ๐Ÿ‡ณ เฆฌเฆพเฆ‚เฆฒเฆพ โ€ข ๐Ÿ‡ฎ๐Ÿ‡ณ เคนเคฟเคจเฅเคฆเฅ€ โ€ข ๐Ÿ‡ฎ๐Ÿ‡ณ เฎคเฎฎเฎฟเฎดเฏ โ€ข ๐Ÿ‡ฉ๐Ÿ‡ช Deutsch โ€ข ๐Ÿ‡ณ๐Ÿ‡ฑ Nederlands


Watch Tutorial Video


GitHub License Hits Main Python Version PRs Welcome Join Discord Documentation GitHub stars


From Zero to Production-Ready Agent in 2 Minutes

Create Bindu Agent is the fastest way to build production-ready AI agents that speak the language of the Internet of Agents. No boilerplate. No configuration hell. Just configure and get a fully deployable agent that communicates using A2A, AP2, and X402 protocols.


Quickstart

Time to first agent: ~2 minutes โฑ๏ธ

On your local machine, navigate to the directory in which you want to create a project directory, and run the following command:

uvx cookiecutter https://github.com/getbindu/create-bindu-agent.git

What Happens Next?

You'll be prompted for:

  • Project name and description
  • Agent framework (Agno, LangChain, CrewAI, etc.)
  • License type (MIT, Apache, BSD, GPL, ISC)
  • Author details

Then, boom! ๐Ÿ’ฅ Your agent project is ready with:

your-agent/
โ”œโ”€โ”€ agent_config.json          # Agent configuration with A2A/AP2/X402 settings
โ”œโ”€โ”€ your_agent/
โ”‚   โ”œโ”€โ”€ main.py               # Your agent entry point (already Bindu-fied!)
โ”‚   โ””โ”€โ”€ __init__.py
โ”œโ”€โ”€ skills/                   # Template for adding agent skills
โ”œโ”€โ”€ tests/                    # Pre-configured pytest tests
โ”œโ”€โ”€ pyproject.toml            # Dependencies managed by uv
โ”œโ”€โ”€ Dockerfile                # Ready for containerization
โ”œโ”€โ”€ .github/workflows/        # CI/CD pipelines
โ””โ”€โ”€ README.md                 # Complete setup instructions

Run Your Agent Locally

cd your-agent
uv sync                       # Install dependencies
uv run python -m your_agent.main  # Start your agent server

That's it! Your agent is now live at http://localhost:8030 and ready to communicate with other agents using A2A, AP2, and X402 protocols.


Why This Matters

The Problem: Building agents is easy. Making them talk to each other? That's the hard part.

The Old Way:

# Write your agent logic
# Figure out API endpoints
# Implement authentication
# Add error handling
# Configure deployment
# Write protocol adapters for A2A, AP2, X402
# Set up monitoring
# ... 3 days later, maybe it works?

The Bindu Way:

uvx cookiecutter https://github.com/getbindu/create-bindu-agent.git
# Answer 4 prompts
# Done. Your agent speaks A2A, AP2, and X402.

Why Use this?

  • 2-Minute Setup: Answer simple questions, get a complete production ready agentic system.
  • Lightweight: No boilerplate. No configuration hell.
  • Simple: No complex setup. Just configure and get a fully deployable agent.
  • Secure: Built-in authentication, error tracking, and monitoring.
  • Protocol-Ready: Built-in support for A2A, AP2, and X402 โ€” your agent speaks the universal language
  • Framework Agnostic: Works with Agno, LangChain, CrewAI, LlamaIndex, FastAgent, and more
  • Production-Ready: Includes CI/CD, testing, Docker, documentation, and deployment configs.
  • Observability: Built-in support for Phoenix, Langfuse, and Jaeger.
  • Best Practices: Pre-configured with ruff, mypy, pytest, pre-commit hooks, and code quality tools
  • Deploy Anywhere: Your agent becomes a living server, ready to join the Internet of Agents

What You Get

This Cookiecutter template scaffolds a complete Bindu Agent project with everything you need:


How It Works

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  1. Run cookiecutter  โ†’  2. Answer prompts  โ†’  3. Deploy!   โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                              โ†“
        Your agent is now live and speaking A2A, AP2, X402
                              โ†“
              Ready to join the Internet of Agents ๐ŸŒ

The Magic Behind the Scenes

When you create a Bindu Agent, you're not just getting a template โ€” you're getting a living server that:

  • Speaks Universal Protocols: A2A for agent-to-agent communication, AP2 for agentic commerce, X402 for payment rails
  • Secure by Design: Built-in authentication, error tracking, and monitoring
  • Discoverable: Your agent can be found and connected by other agents across the web
  • Framework Flexible: Bring your own agent framework (Agno, LangChain, CrewAI, etc.)
  • Production-Ready: From localhost to cloud in minutes, not days

The Vision

a peek into the night sky
}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}
{{            +             +                  +   @          {{
}}   |                *           o     +                .    }}
{{  -O-    o               .               .          +       {{
}}   |                    _,.-----.,_         o    |          }}
{{           +    *    .-'.         .'-.          -O-         {{
}}      *            .'.-'   .---.   `'.'.         |     *    }}
{{ .                /_.-'   /     \   .'-.\                   {{
}}         ' -=*<  |-._.-  |   @   |   '-._|  >*=-    .     + }}
{{ -- )--           \`-.    \     /    .-'/                   {{
}}       *     +     `.'.    '---'    .'.'    +       o       }}
{{                  .  '-._         _.-'  .                   {{
}}         |               `~~~~~~~`       - --===D       @   }}
{{   o    -O-      *   .                  *        +          {{
}}         |                      +         .            +    }}
{{ jgs          .     @      o                        *       {{
}}       o                          *          o           .  }}
{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{

Each symbol is an agent โ€” a spark of intelligence. And the single tiny dot is Bindu, the origin point in the Internet of Agents.


The Internet of Agents

Your Bindu Agent isn't just another API โ€” it's a citizen of the Internet of Agents:

  • A2A (Agent-to-Agent): Seamless communication between AI agents
  • AP2 (Agentic Protocol 2): Commerce and transaction capabilities for agents
  • X402 (Payment Protocol): Built-in payment rails for agent services

Each protocol is pre-configured in your agent_config.json. Your agent speaks the universal language from day one.


Learn More


Built for the Future

We're entering the age of agent swarms โ€” where thousands of AI agents collaborate, negotiate, and transact. Bindu ensures your agent is ready for this future:

  • Interoperable: Works with any agent framework
  • Standards-Compliant: A2A, AP2, X402 protocols built-in
  • Production-Grade: Not a toy, not a demo โ€” real infrastructure
  • Community-Driven: Join the movement at getbindu

Contributing

We ๐Ÿ’› contributions! Whether you're:

  • Adding new agent framework templates
  • Improving documentation
  • Fixing bugs
  • Sharing your Bindu agent creations

Check out our Contributing Guidelines and join us on Discord!


Acknowledgements

This project is partially based on cookiecutter-uv

Star History

Star History Chart


Built with ๐Ÿ’› by the team from Amsterdam ๐ŸŒท
Happy Bindu! ๐ŸŒป๐Ÿš€โœจ

From idea to Internet of Agents in 2 minutes.
Your agent. Your framework. Universal protocols.

โญ Star us on GitHub โ€ข ๐Ÿ’ฌ Join Discord โ€ข ๐Ÿ“š Read the Docs

About

A cookiecutter template for Python agent projects that use uv for dependency management

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 5