examples/

DSPy-Go Examples

This directory contains runnable examples for the main module, agent, optimization, and tooling surfaces in DSPy-Go.

Recommended Starting Points

Agents

• agents - ReAct patterns, orchestration, and memory
• ace_basic - Minimal ACE usage without live provider calls
• ace_react - ACE layered onto a ReAct-style agent
• native_agent_session - Native tool-calling agent with persisted sessions
• a2a_composition - Multi-agent orchestration using A2A

Long-Context And RLM

• rlm - Basic live RLM run
• rlm_context_policy - Compare full, checkpointed, and adaptive replay
• rlm_subrlm_budgets - Deterministic sub-RLM direct/total budget demo
• rlm_oolong - Benchmark the RLM module on OOLONG tasks
• rlm_oolong_gepa - Optimize an adaptive RLM agent, save the optimized program, restore it, and replay it

Modules

• parallel - Concurrent batch processing
• refine - Iterative answer improvement
• xml_adapter - XML structured output adapters
• multimodal - Image + text workflows

Tools And Integrations

• smart_tool_registry - Intelligent tool selection
• tool_chaining - Sequential tool pipelines
• tool_composition - Composite tools and orchestration
• mcp_optimizer - MCP-backed optimization workflow
• oauth_login - OAuth integration example

Research And Miscellaneous

• others/gepa - Lower-level GEPA examples
• others/mipro - MIPRO examples
• others/simba - SIMBA examples
• multi_chain_comparison - Compare reasoning strategies

Running Examples

From the repo root:

go run ./examples/rlm_subrlm_budgets
go run ./examples/parallel
GEMINI_API_KEY=... go run ./examples/rlm_context_policy -provider gemini
GOOGLE_API_KEY=... go run ./examples/rlm_oolong_gepa -provider gemini -artifact /tmp/oolong-program.json

Many example directories also include their own README.md with task-specific notes and flags.

Notes

• Examples under rlm, rlm_context_policy, rlm_oolong, and rlm_oolong_gepa can make live provider calls unless explicitly scripted.
• rlm_subrlm_budgets is deterministic and does not require an API key.
• The others/ subtree is intentionally more experimental and lower-level than the curated examples above.

🤝 Contributing

When adding new examples:

1. Create a dedicated directory for your example
2. Include a README.md with clear usage instructions
3. Add comprehensive comments explaining key concepts
4. Include both basic and advanced usage patterns
5. Ensure examples are self-contained and runnable

📄 License

All examples are provided under the same license as DSPy-Go. See the main repository LICENSE file for details.