Add Example Agent

Overview

Examples under examples/ are the fastest way users learn Bindu. Each is a self-contained mini-project demonstrating one integration pattern. Follow existing structure, users and agents discover examples by convention, so inconsistency hurts discoverability.

Inputs

• <name>: kebab-case slug, e.g. pdf-research-agent, weather-research.
• <framework>: Python (agno, langchain, langgraph, crewai) or TypeScript (openai, langchain).
• <purpose>: one-sentence "what this demonstrates".

Safety

• Never commit .env files. Only .env.example with placeholder values and # pragma: allowlist secret to bypass pre-commit.
• Never hardcode API keys, even in comments.
• Never introduce paid-only services without a free-tier alternative. Examples must be runnable by a new user within minutes.
• Never hardcode ports, default to 3773 with BINDU_PORT override.

Execution Contract

1. Pick a matching template from existing examples.
2. Create the directory with the required file set.
3. Wire the handler to bindufy() with consistent config.
4. Write a README following the four-section pattern below.
5. Update parent indexes.
6. Test end-to-end in a clean environment before committing.

Steps

1. Pick a template

Find an existing example in the same framework and match its layout:

• Python, simple: examples/beginner/
• Python, multi-agent: examples/agent_swarm/
• Python, agno: examples/medical_agent/
• Python, langgraph: examples/langgraph_blog_writing_agent/
• TypeScript, openai: examples/typescript-openai-agent/
• TypeScript, langchain: examples/typescript-langchain-agent/

2. Create the directory