A powerful, extensible agent framework leveraging ReACT methodology for autonomous task execution and human-in-the-loop collaboration.
-
Install the package:
pip install hello_agent
-
Set up your environment variables:
Create a
.envfile in the root directory of your project and add the following:# OpenRouter API Key # Get your API key from https://openrouter.ai/ OPENROUTER_API_KEY=your_api_key_here # Optional: LLM Model Settings # Default models are set in agents.yaml, but can be overridden here # RESEARCHER_MODEL=anthropic/claude-2 # EXECUTOR_MODEL=anthropic/claude-2 # ANALYZER_MODEL=anthropic/claude-2 # Optional: Debug Mode # Set to true to enable additional logging # DEBUG=false # Optional: HITL Settings # Enable/disable human-in-the-loop by default # Can be overridden with --hitl flag # HITL_ENABLED=false
-
Run the agent:
python agent/main.py
| Feature | Description |
|---|---|
| ReACT Methodology | Structured reasoning and action framework for intelligent task execution |
| Multi-Modal Tasks | Research, execution, and analysis capabilities |
| Streaming Responses | Real-time output with progress tracking |
| Human (HITL) Integration | Optional human validation at key decision points |
| Extensible Tools | Modular architecture for custom tool integration |
| Advanced LLM Support | Powered by OpenRouter API for state-of-the-art language models |
| Capability | Details |
|---|---|
| Research | Information gathering, analysis, and synthesis |
| Execution | Task implementation with validation and quality checks |
| Analysis | Performance metrics, optimization, and recommendations |
| HITL | Human validation for critical decisions |
| Progress Tracking | Real-time status updates and metrics |
| Error Recovery | Robust error handling and state preservation |
| Mode | Description |
|---|---|
| Autonomous | Self-directed task execution with ReACT methodology |
| HITL | Interactive mode with human validation points |
| Streaming | Real-time response processing and updates |
| Component | Technology |
|---|---|
| Core Framework | Python 3.8+ |
| LLM Integration | OpenRouter API |
| Task Management | CrewAI |
| Configuration | YAML-based |
| API | REST with OpenAPI spec |
| Documentation | Markdown + Examples |
| Metric | Target |
|---|---|
| Response Time | < 2s for standard operations |
| Streaming Latency | < 100ms |
| Task Success Rate | > 95% |
| HITL Integration | < 5s response time |
| Feature | Implementation |
|---|---|
| Authentication | OpenRouter API key |
| Configuration | Environment variables |
| Rate Limiting | 100 requests/hour |
| Access Control | Role-based permissions |
Comprehensive guides available for all aspects:
| Guide | Content |
|---|---|
| User Guide | Getting started and basic usage |
| Templates | Customizing agent responses |
| Tools | Extending agent capabilities |
| Configuration | System setup and options |
| Advanced | Complex implementations |
| Memory/Storage | Data management |
| HITL | Human integration guide |
| Industry | Applications |
|---|---|
| Research | Literature review, data analysis |
| Development | Code generation, testing |
| Operations | System monitoring, optimization |
| Support | Customer service, documentation |
| Analysis | Performance metrics, reporting |
| Method | Description |
|---|---|
| CLI | Command-line interface |
| Python API | Direct library integration |
| REST API | HTTP endpoints |
| AI Plugin | OpenAI plugin compatibility |
| Component | Status |
|---|---|
| PyPI Package | ✅ Available |
| Documentation | ✅ Comprehensive |
| Examples | ✅ Included |
| Community | 🚀 Growing |
| Feature | Status |
|---|---|
| Multi-Agent Support | 🚧 In Development |
| Advanced Analytics | 🎯 Planned |
| GUI Interface | 💡 Proposed |
| Cloud Deployment | 🎯 Planned |
Join our community! We welcome contributions of all kinds:
- 🐛 Bug Reports
- 💡 Feature Suggestions
- 🔧 Code Contributions
- 📚 Documentation Improvements
MIT License - See LICENSE for details.
- Built with CrewAI
- Powered by OpenRouter
Made by rUv with 💫 for the AI community