# How to Publish Agents

Before submitting your agents, make sure that you have read and followed the guidelines in [How to Develop Agents](/aios-docs/aios-agent/how-to-develop-agents.md) 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="/files/jzPX4UixT0OMcHcd5kmN" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aios.foundation/aios-docs/aios-agent/how-to-publish-agents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.