setup-platform

Guides fresh-clone setup of an AgentOS platform through Docker, environment, boot, and first-agent creation.

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/martin-cousseau/refund-arena --skill setup-platform-martin-cousseau
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-platform
Source: https://github.com/martin-cousseau/refund-arena/tree/main/backend/.agents/skills/setup-platform
Command: npx skills add https://github.com/martin-cousseau/refund-arena --skill setup-platform-martin-cousseau

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a self-hosted Agno AgentOS platform from a fresh clone involves many failure-prone steps — Docker checks, environment configuration, container builds, MCP verification, and UI connection — and this Skill walks a coding agent through the entire sequence autonomously. ## Core Features & Use Cases - End-to-end bootstrap: Confirms Docker is running, creates and configures .env with OPENAI_API_KEY, builds and starts containers with docker compose up -d --build, and polls the API until healthy. - Verification and UI connection: Runs mcp_check.sh to prove the MCP endpoint returns a real agent answer, then provides the exact settings table for connecting the AgentOS UI at os.agno.com. - First agent and hand-over: Builds the user's first agent via the create-agent skill, moves the repo to a private remote, and hands off the follow-up skills (extend-agent, improve-agent, deploy-platform). - Use Case: A developer clones the Refund Arena monorepo on a new machine and asks the agent to set up the platform; the agent runs each step, stops only for secrets or sign-ins, and finishes with a live agent answering over MCP. ## Quick Start Ask the agent to set up the platform from this fresh clone and get my first agent running.

Frequently Asked Questions about setup-platform

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an Agno AgentOS platform from a fresh clone?▼

Run the setup workflow which confirms Docker is running, copies .env.example to .env, sets OPENAI_API_KEY, builds containers with docker compose up -d --build, and polls localhost:8000/docs until the API responds.

How do I verify the MCP endpoint is working after setup?▼

Run ./backend/scripts/mcp_check.sh from the repository root. It prints "MCP OK" along with a real answer from the Platform Manager agent, confirming the MCP server is live.

How do I connect the AgentOS UI to a local instance?▼

Open https://os.agno.com, choose a Local connection type, set the endpoint to http://localhost:8000, name it, and click Connect OS. Users arriving from Agno onboarding can flip back to the Awaiting connection screen.

What should I do if docker compose containers never come up?▼

Read the logs with docker compose logs backend to diagnose the failure. First builds can take several minutes, so poll http://localhost:8000/docs patiently before assuming an error.

Can I move the platform to my own private repository after setup?▼

Yes. Rename origin to upstream, add your private repo as the new origin, and push. With gh signed in, gh repo create agent-platform --private --source=. --push does it in one step.