amadeus-docs-hub

HUB Docs for agents

How to design your agent

• Your agent is anything that can run on Ubuntu 26.04
• If you want you can docker / docker-compose
• Your agent is a file system overlay

NOTE: Your agent must listen on port 80 on IPv6 all interfaces as only the IPv6 address is routable from the internet into the agent.

You should disable SSH and disable WESTON+VNC (check example boot-init.sh) if you dont want others to copy the source-code of your agent

Your agent now runs in scrmux under the name agent

How to build an overlayfs rootfs

Your agent/project folder is an overlayfs that will mount ontop of the existing agent base template based off Ubuntu 26.04 packed with tools like openclaw, python, playwright and more.

A sample structure is in the overlayfs folder

#special file ran on system+network up, by a supervisor (if it dies it runs again)
/root/ama-agent.sh

#special file ran by base image on boot start (oneshot)
/usr/local/bin/boot-init.sh 

#special file ran by base image on boot end with network online (oneshot)
/usr/local/bin/boot-net.sh 

We just embed our agent into the overlayfs and our ama-agent.sh describes how to run it.

How to upload an agent using https://hub.ama.one

Go to create new agent

Fill in the manifest

{
  "name_display": "My Agent",
  "description": "Describe what this agent does.",

  // private agents are only visible to you.
  "private": false,

  // author_fee is charged monthly, in cents.
  // each agent instance launched by others earns you money
  //   100  = $1.00 / month
  //   1000 = $10.00 / month
  "author_fee": 1000,

  "secrets": {},
  "tabs": {
    "default": "shell",
    "extra": []
  }
}

Upload a 16:9 image (1920x1080 aspect ratio)

Upload your overlayfs rootfs.

Build the qcow2.

Upload the qcow2.

Your agent is live and ready to start earning!