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
.env
file 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