Skip to main content
AgentSystems is an open agent platform where agents can be public or private. This quickstart deploys a public agent - your agent will be available on Docker Hub for others to pull and run. You can also deploy private agents for your organization - see the next steps after completing this guide.

​
Prerequisites

​
Step 1: Get the Template

Go to github.com/agentsystems/agent-template and click “Use this template” → “Create a new repository”. Name it demo-agent and clone it: 
git clone https://github.com/your-org/demo-agent.git
cd demo-agent

​
Step 2: Customize Agent Metadata

Edit agent.yaml and set:
  • developer - Your GitHub username or organization
  • name - Your agent name (e.g., demo-agent)
  • description - What your agent does
  • container_image - Full registry path (e.g., docker.io/your-org/demo-agent)
Edit metadata.yaml and set:
  • version - Your version number (e.g., “0.1.0”)
  • model_dependencies - Keep gemma3:1b (works locally without API keys)
See the template files for all available fields and examples.

​
Step 3: Build and Push

Docker Hub creates new repositories as public by default. Your agent image will be publicly accessible immediately after pushing, allowing anyone to pull and run your agent.
Log in to Docker Hub: 
docker login
Build and push (replace your-org): 
docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t your-org/demo-agent:0.1.0 \
  -t your-org/demo-agent:latest \
  --push \
  .
This takes 5-10 minutes.

​
Step 4: Verify Repository Visibility

Confirm your repository is public:
  1. Go to hub.docker.com
  2. Open your repository: your-org/demo-agent
  3. Check Settings → Visibility settings shows Public
If it shows Private, change it to Public and save.

​
Step 5: Add Agent to Platform

Open localhost:3001/configuration/agents:
  • Name: demo-agent
  • Repository: your-org/demo-agent
  • Registry: dockerhub_public
  • Tag: latest
  • Egress Allowlist: Leave blank (no external API calls needed)
Click “Add Agent”.

​
Step 6: Restart and Test

Navigate to your AgentSystems deployment directory and restart: 
cd /path/to/agentsystems
agentsystems restart
Test it:
  1. Go to localhost:3001/agents
  2. Click on demo-agent
  3. Click “Turn On”
  4. Click “Execute”
You should see historical events and a story!

​
What You Built

Your agent is now deployed on the open AgentSystems platform. Your agent:
  • Uses gemma3:1b (local model, no API keys needed)
  • Accepts a date and returns historical events
  • Runs in a Docker container
  • Is accessible at http://localhost:18080/invoke/demo-agent
  • Is publicly available on Docker Hub for others to use

​
Next Steps

Deploy a Private Agent: This quickstart deployed a public agent. To keep your agent private for your organization, see Deploying Private Agents.
⌘I