# How to Publish Agents

Before submitting your agents, make sure that you have read and followed the guidelines in [How to Develop Agents](https://docs.aios.foundation/aios-docs/aios-agent/how-to-develop-agents) and check the following things

1. Tested your agent locally and verified its functionality
2. Organized agent files according to the required structure
3. Configured the correct versioning in your agent's configuration file

After you develop your agents locally and organize the agent files in the structure, you can run the following file to upload your agent. 

```python
upload-agent \
    --agent_path <agent_path> \
    --agenthub_url <agenthub_url>
```

For example, if you run the following command

```python
upload-agent \ 
    --agent_path /home/user/xxx/Cerebrum/cerebrum/example/agents/academic_agent \
    --agenthub_url https://app.aios.foundation
```

It is expected to show the following feedback if your agent has been uploaded successfully.&#x20;

<figure><img src="https://4233234616-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5h7XvlMFgKMtRboLGG1i%2Fuploads%2FiMr6RpP272EKPTCEEuDx%2FScreenshot%202024-12-23%20at%208.53.11%20AM.png?alt=media&#x26;token=c0fc033d-5c77-4738-ae63-d53248eb24af" alt="" width="563"><figcaption><p>Successfully uploaded example.</p></figcaption></figure>

{% hint style="danger" %}
It is important to mention that the version guidelines as below

#### Version Format

* Follow semantic versioning (MAJOR.MINOR.PATCH)
* Example: 1.0.0, 1.1.0, 2.0.0

#### Important Version Rules

1. **Immutable Versions**: Similar to PyPI packages and Huggingface models, uploaded agent versions are immutable and cannot be modified
2. **Version Updates**: To upload changes:
   * Increment the version number in your agent's config.json
   * Major version (X.0.0): Breaking changes
   * Minor version (0.X.0): New features, backward compatible
   * Patch version (0.0.X): Bug fixes
     {% endhint %}