Thank you for your interest in contributing to AgentSystems! This project consists of multiple repositories working together to provide a complete AI agent platform.
AgentSystems is organized into several focused repositories:
- agentsystems - Main documentation and platform overview
- agent-control-plane - Gateway and orchestration services
- agentsystems-sdk - CLI and deployment tools
- agentsystems-ui - Web interface
- agentsystems-toolkit - Development libraries
- agent-template - Reference implementation (this repo)
# Clone and setup
git clone https://github.com/agentsystems/agent-template.git
cd agent-template
# Create virtual environment
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
# Start development server
uvicorn main:app --reload --port 8000
# Test the agent
curl -X POST http://localhost:8000/invoke -d '{"date": "July 4"}'- Fork this repository
- Create a feature branch from main
- Make your changes with appropriate tests
- Submit a pull request with a clear description
- Follow the existing code style in each repository
- Include tests for new functionality
- Update documentation as needed
- Use clear, descriptive commit messages
- Add type hints to all new functions
- Include docstrings for public APIs
- Update documentation if you're changing functionality
- Add tests for new features
- Ensure all CI checks pass
- Request review from maintainers
Please read our Code of Conduct to understand our community standards.
- General questions: Open a discussion in the main repository
- Bug reports: Create an issue in this repository
We appreciate all contributions, from typo fixes to major features!