Submit Your Agent

Ready to submit? Follow these final steps to create your pull request.

Pre-Submission Checklist

Agent code is complete and tested

metadata.json file is created with all required fields

README.md file includes setup and usage instructions

Code follows Python best practices and includes type hints

Agent handles errors gracefully

Dependencies are documented

Sample prompts are provided in metadata.json

Use cases and tags are accurately described

Submission Steps

1. Fork and Clone the Repository

Fork the Agent Hub repository on GitHub, then clone your fork locally.

git clone https://github.com/YOUR_USERNAME/adk_samples.git

2. Create Your Agent Directory

Create a new directory for your agent following the naming convention (lowercase with underscores).

mkdir your_agent_name

3. Add Your Agent Code

Add your agent implementation, tools, and configuration files to the directory.

4. Create metadata.json

Create a metadata.json file in your agent directory with all required fields.

5. Commit and Push

Commit your changes and push to your fork.

git add your_agent_name/

git commit -m "Add your_agent_name agent"

git push origin main

6. Create Pull Request

Navigate to the original repository on GitHub and create a pull request with a clear description of your agent.

Create Pull Request

Pull Request Template

Use this template when creating your pull request:

## Agent: [Agent Name]

### Description
Brief description of what your agent does.

### Use Cases
- Use case 1
- Use case 2

### Tools Used
- Tool 1
- Tool 2

### Testing
Describe how you tested your agent.

### Documentation
Link to any additional documentation or examples.

What Happens Next?

• Your pull request will be reviewed by maintainers
• Feedback may be requested for improvements
• Once approved, your agent will be merged and appear in the Agent Hub
• You'll be credited as the agent author

Open GitHub Repository