Open-source agentic framework for building intelligent research agents using Schema-Guided Reasoning. The project provides a core library with a extendable BaseAgent interface implementing a two-phase architecture and multiple ready-to-use research agent implementations built on top of it.

The library includes extensible tools for search, reasoning, and clarification, real-time streaming responses, OpenAI-compatible REST API. Works with any OpenAI-compatible LLM, including local models for fully private research.

Get started quickly with our documentation:

• Project Docs - Complete project documentation
• Framework Quick Start Guide - Get up and running in minutes
• DeepSearch Service Documentation - REST API reference with examples

pip install sgr-agent-core

The project includes example research agent configurations in the examples/ directory. To get started with deep research agents:

1. Copy and configure the config file:

cp examples/sgr_deep_research/config.yaml my_config.yaml
# Edit my_config.yaml and set your API keys:
# - llm.api_key: Your OpenAI API key
# - search.tavily_api_key: Your Tavily API key (optional)

2. Run the API server using the sgr utility:

sgr --config-file examples/sgr_deep_research/config.yaml

The server will start on http://localhost:8010 with OpenAI-compatible API endpoints.

Note: You can also run the server directly with Python:

python -m sgr_agent_core.server --config-file examples/sgr_deep_research/config.yaml

For more examples and detailed usage instructions, see the examples/ directory.

Performance Metrics on gpt-4.1-mini:

• Accuracy: 86.08%
• Correct: 3,724 answers
• Incorrect: 554 answers
• Not Attempted: 48 answers

More detailed benchmark results are available here.

All development is driven by pure enthusiasm and open-source community collaboration. We welcome contributors of all skill levels!

• SGR Concept Creator // @abdullin
• Project Coordinator & Vision // @VaKovaLskii
• Lead Core Developer // @virrius
• API Development // @EvilFreelancer
• DevOps & Deployment // @mixaill76

If you have any questions - feel free to join our community chat↗️ or reach out Valerii Kovalskii↗️.

This project is developed by the neuraldeep community. It is inspired by the Schema-Guided Reasoning (SGR) work and SGR Agent Demo↗️ delivered by "LLM Under the Hood" community and AI R&D Hub of TIMETOACT GROUP Österreich↗️

This project is supported by the AI R&D team at red_mad_robot, providing research capacity, engineering expertise, infrastructure, and operational support.

Learn more about red_mad_robot: redmadrobot.ai↗️ habr↗️ telegram↗️