[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75ZPM54WF3BDEPAP5HSK7DF":3,"skill-same:01M75ZPM54WF3BDEPAP5HSK7DF":98},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M75ZPM54WF3BDEPAP5HSK7DF","deploy-docker-compose",null,"Run the Omnigent server as a Docker compose stack (server + Postgres) on any Docker host — your laptop, a VPS, EC2 by hand, or as the base layer of any container-platform deploy. Invoke when the user wants to build the image, bring up the compose stack, debug the stack on a host they already have, or extend the stack for a new platform.","Z-57-z\u002Fgameops-agentic-framework","Z-57-z","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F266453567?v=4","01M75ZPAKW613DR189K5ZCHGNY","bdrop","01M75ZPAMGJXY9P3EMPAEW1A2Z",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: deploy-docker-compose\ndescription: Run the Omnigent server as a Docker compose stack (server + Postgres) on any Docker host — your laptop, a VPS, EC2 by hand, or as the base layer of any container-platform deploy. Invoke when the user wants to build the image, bring up the compose stack, debug the stack on a host they already have, or extend the stack for a new platform.\n---\n\n# Run Omnigent as a Docker compose stack\n\nThe `Dockerfile` here is the single image used by every non-Databricks\ndeploy path. It bundles the FastAPI server + a pre-built ap-web SPA\ninto a slim Python runtime. The compose file pairs it with Postgres\nand exposes the server on port 8000.\n\nThe image is \"external runner only\" — it does NOT include `tmux`,\nthe harness SDKs, or anything that would let it execute agent code\nin-process. Runners live on user machines and dial in via the\nWebSocket tunnel. This keeps the image small (~250 MB), the security\nboundary clean (server doesn't execute user code), and the deploy\nshape consistent across hosts.\n\nThe same Dockerfile also has a `host` target — the prebaked Omnigent\nHOST image (`omnigent-host`) that remote sandboxes boot from\n(`omnigent sandbox create --provider modal`, server-launched managed\nhosts). It is the inverse profile: full omnigent install plus git +\ntmux, no SPA, no psycopg, no server entrypoint. Both images are\npublished by the same workflows with the same `:sha-\u003Cshort>` \u002F\n`:latest` \u002F `:vX.Y.Z` tag scheme. See the \"Host image\" section in\n`README.md` here.\n\n## TL;DR — bring it up\n\n```bash\ncd deploy\u002Fdocker\ncp .env.example .env             # edit POSTGRES_PASSWORD at minimum\ndocker compose up -d --build\ndocker compose logs -f omnigent   # Ctrl-C when you see \"Uvicorn running\"\n```\n\nServer is on http:\u002F\u002Flocalhost:8000.\n\n## Files\n\n| | |\n|---|---|\n| `Dockerfile` | Multi-stage build with two final targets. `web-builder` (node:20) runs `npm install && npm run build` on `ap-web\u002F`. `builder` (python:3.12) installs omnigent into `\u002Fopt\u002Fvenv`; `server-builder` overlays the SPA bundle from `web-builder` and adds psycopg. The default target (`runtime`) copies the venv + `\u002Fbuild\u002F` from `server-builder` and runs `entrypoint.py`. `--target host` builds the host image instead (from `builder`: omnigent + git\u002Ftmux, no SPA\u002Fpsycopg\u002Fentrypoint). |\n| `Dockerfile.dockerignore` | BuildKit-aware exclude. Trims `deploy\u002Fdatabricks\u002F`, `deploy\u002Faws\u002F`, tests, dev tooling — keeps the build context small. |\n| `entrypoint.py` | Server process entrypoint. Reads `DATABASE_URL`, runs Alembic migrations, builds the SQLAlchemy stores, calls `create_app()`, runs uvicorn. Single source of truth for what env vars the container respects. |\n| `docker-compose.yaml` | Two services: `postgres` (16-alpine, persistent volume) and `omnigent` (built from the Dockerfile, depends on postgres healthcheck). Build context is `..\u002F..` (repo root). |\n| `.env.example` | Documents every env var the compose file passes through: `POSTGRES_PASSWORD`, `OMNIGENT_PORT`, all the `OMNIGENT_AUTH_*` and `OMNIGENT_OIDC_*` vars. |\n| `README.md` | Customer-facing quickstart + the OIDC walkthrough (GitHub OAuth, Google Workspace, generic OIDC). |\n\n## Iterating on the image\n\n```bash\n# Force a clean rebuild after a Dockerfile or source change\ndocker compose build --no-cache omnigent\n\n# Reset everything (drops the DB + artifact volumes)\ndocker compose down -v\ndocker compose up -d --build\n```\n\n`POSTGRES_PASSWORD` is only honored on first init of the data volume.\nIf you change it in `.env`, you need `docker compose down -v` before\n`up -d` or the server will fail to authenticate against the existing\ncluster.\n\n## Common debugging\n\n| Symptom | Likely cause | First check |\n|---|---|---|\n| Root URL returns `{\"service\":\"omnigent\",…}` instead of the SPA | npm build didn't produce the bundle inside the container | `docker compose exec omnigent ls \u002Fbuild\u002Fomnigent\u002Fserver\u002Fstatic\u002Fweb-ui\u002F` — empty = the `web-builder` stage didn't run cleanly. Rebuild with `--no-cache`. |\n| `ModuleNotFoundError: No module named 'uvicorn'` at startup | venv copy didn't pick up the install | Sanity-check the Dockerfile's `VIRTUAL_ENV=\u002Fopt\u002Fvenv` is set before the `uv pip install` calls. |\n| `psycopg.OperationalError: password authentication failed` | `POSTGRES_PASSWORD` changed in `.env` after the data volume was initialized | `docker compose down -v` then `up -d` (wipes the DB). |\n| Web UI loads but new chats hang forever | Expected — runners are external. The UI's landing page prints the CLI command to launch a runner. |\n\n## Extending to a new platform\n\nCloud Run, Fly.io, Render, k8s, HF Spaces — they all consume the\nsame image. The platform-specific bit is the manifest (`fly.toml`,\n`service.yaml`, Helm chart, Spaces config) and any platform-managed\nTLS \u002F DB wiring. Put that under `deploy\u002F\u003Cplatform>\u002F` next to\n`docker\u002F`, with its own README + SKILL.\n\n## Related skills + docs\n\n- [`deploy\u002FREADME.md`](..\u002FREADME.md) — the deploy-options menu.\n- `designs\u002FOIDC_AUTH.md` — full native OIDC design.\n","# Run Omnigent as a Docker compose stack\n\nThe `Dockerfile` here is the single image used by every non-Databricks\ndeploy path. It bundles the FastAPI server + a pre-built ap-web SPA\ninto a slim Python runtime. The compose file pairs it with Postgres\nand exposes the server on port 8000.\n\nThe image is \"external runner only\" — it does NOT include `tmux`,\nthe harness SDKs, or anything that would let it execute agent code\nin-process. Runners live on user machines and dial in via the\nWebSocket tunnel. This keeps the image small (~250 MB), the security\nboundary clean (server doesn't execute user code), and the deploy\nshape consistent across hosts.\n\nThe same Dockerfile also has a `host` target — the prebaked Omnigent\nHOST image (`omnigent-host`) that remote sandboxes boot from\n(`omnigent sandbox create --provider modal`, server-launched managed\nhosts). It is the inverse profile: full omnigent install plus git +\ntmux, no SPA, no psycopg, no server entrypoint. Both images are\npublished by the same workflows with the same `:sha-\u003Cshort>` \u002F\n`:latest` \u002F `:vX.Y.Z` tag scheme. See the \"Host image\" section in\n`README.md` here.\n\n## TL;DR — bring it up\n\n```bash\ncd deploy\u002Fdocker\ncp .env.example .env             # edit POSTGRES_PASSWORD at minimum\ndocker compose up -d --build\ndocker compose logs -f omnigent   # Ctrl-C when you see \"Uvicorn running\"\n```\n\nServer is on http:\u002F\u002Flocalhost:8000.\n\n## Files\n\n| | |\n|---|---|\n| `Dockerfile` | Multi-stage build with two final targets. `web-builder` (node:20) runs `npm install && npm run build` on `ap-web\u002F`. `builder` (python:3.12) installs omnigent into `\u002Fopt\u002Fvenv`; `server-builder` overlays the SPA bundle from `web-builder` and adds psycopg. The default target (`runtime`) copies the venv + `\u002Fbuild\u002F` from `server-builder` and runs `entrypoint.py`. `--target host` builds the host image instead (from `builder`: omnigent + git\u002Ftmux, no SPA\u002Fpsycopg\u002Fentrypoint). |\n| `Dockerfile.dockerignore` | BuildKit-aware exclude. Trims `deploy\u002Fdatabricks\u002F`, `deploy\u002Faws\u002F`, tests, dev tooling — keeps the build context small. |\n| `entrypoint.py` | Server process entrypoint. Reads `DATABASE_URL`, runs Alembic migrations, builds the SQLAlchemy stores, calls `create_app()`, runs uvicorn. Single source of truth for what env vars the container respects. |\n| `docker-compose.yaml` | Two services: `postgres` (16-alpine, persistent volume) and `omnigent` (built from the Dockerfile, depends on postgres healthcheck). Build context is `..\u002F..` (repo root). |\n| `.env.example` | Documents every env var the compose file passes through: `POSTGRES_PASSWORD`, `OMNIGENT_PORT`, all the `OMNIGENT_AUTH_*` and `OMNIGENT_OIDC_*` vars. |\n| `README.md` | Customer-facing quickstart + the OIDC walkthrough (GitHub OAuth, Google Workspace, generic OIDC). |\n\n## Iterating on the image\n\n```bash\n# Force a clean rebuild after a Dockerfile or source change\ndocker compose build --no-cache omnigent\n\n# Reset everything (drops the DB + artifact volumes)\ndocker compose down -v\ndocker compose up -d --build\n```\n\n`POSTGRES_PASSWORD` is only honored on first init of the data volume.\nIf you change it in `.env`, you need `docker compose down -v` before\n`up -d` or the server will fail to authenticate against the existing\ncluster.\n\n## Common debugging\n\n| Symptom | Likely cause | First check |\n|---|---|---|\n| Root URL returns `{\"service\":\"omnigent\",…}` instead of the SPA | npm build didn't produce the bundle inside the container | `docker compose exec omnigent ls \u002Fbuild\u002Fomnigent\u002Fserver\u002Fstatic\u002Fweb-ui\u002F` — empty = the `web-builder` stage didn't run cleanly. Rebuild with `--no-cache`. |\n| `ModuleNotFoundError: No module named 'uvicorn'` at startup | venv copy didn't pick up the install | Sanity-check the Dockerfile's `VIRTUAL_ENV=\u002Fopt\u002Fvenv` is set before the `uv pip install` calls. |\n| `psycopg.OperationalError: password authentication failed` | `POSTGRES_PASSWORD` changed in `.env` after the data volume was initialized | `docker compose down -v` then `up -d` (wipes the DB). |\n| Web UI loads but new chats hang forever | Expected — runners are external. The UI's landing page prints the CLI command to launch a runner. |\n\n## Extending to a new platform\n\nCloud Run, Fly.io, Render, k8s, HF Spaces — they all consume the\nsame image. The platform-specific bit is the manifest (`fly.toml`,\n`service.yaml`, Helm chart, Spaces config) and any platform-managed\nTLS \u002F DB wiring. Put that under `deploy\u002F\u003Cplatform>\u002F` next to\n`docker\u002F`, with its own README + SKILL.\n\n## Related skills + docs\n\n- [`deploy\u002FREADME.md`](..\u002FREADME.md) — the deploy-options menu.\n- `designs\u002FOIDC_AUTH.md` — full native OIDC design.\n",{"name":5,"description":7},"main","1374f23e8030824a800237313e9eb787982ba984","deploy\u002Fdocker","https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework","https:\u002F\u002Fgithub.com\u002FZ-57-z","2026-07-17 01:44:05",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add Z-57-z\u002Fgameops-agentic-framework --skill deploy-docker-compose",{"tool":36,"command":37},"bunx","bunx skills add Z-57-z\u002Fgameops-agentic-framework --skill deploy-docker-compose",{"tool":39,"command":40},"pnpm","pnpm dlx skills add Z-57-z\u002Fgameops-agentic-framework --skill deploy-docker-compose","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002FSKILL.md",true,[44,50,56,60,64,70,74,78,82,86,90,94],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},".env.example","OTHER","其他",10919,"https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002F.env.example",{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"bootstrap.sh","SCRIPT","脚本",3623,"https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002Fbootstrap.sh",{"path":57,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":58,"sourceHtmlUrl":59},"Caddyfile",835,"https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002FCaddyfile",{"path":61,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":62,"sourceHtmlUrl":63},"config.yaml.example",2045,"https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002Fconfig.yaml.example",{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"docker-compose.https.yaml","REFERENCE","参考文档",1397,"https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002Fdocker-compose.https.yaml",{"path":71,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":72,"sourceHtmlUrl":73},"docker-compose.yaml",8043,"https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002Fdocker-compose.yaml",{"path":75,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":76,"sourceHtmlUrl":77},"Dockerfile",13463,"https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002FDockerfile",{"path":79,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":80,"sourceHtmlUrl":81},"Dockerfile.dockerignore",1491,"https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002FDockerfile.dockerignore",{"path":83,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":84,"sourceHtmlUrl":85},"Dockerfile.prebuilt",414,"https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002FDockerfile.prebuilt",{"path":87,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":88,"sourceHtmlUrl":89},"Dockerfile.ubi",4772,"https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002FDockerfile.ubi",{"path":91,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":92,"sourceHtmlUrl":93},"entrypoint.py",17390,"https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002Fentrypoint.py",{"path":95,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":96,"sourceHtmlUrl":97},"README.md",11532,"https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Fdeploy\u002Fdocker\u002FREADME.md",[99,106,113,120,125,130],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":19},"01M75ZR1D4EYADG5PZHXW1KV3R","deep-research","Research checklist and source-quality guidance for the archer e2e fixture.","https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Ftests\u002Fresources\u002Fexamples\u002Farcher\u002Fskills\u002Fdeep-research\u002FSKILL.md",[],[],{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":19},"01M75ZQZW19WTYYT55NYBXBQDZ","pi-e2e-xyz-greet-c4a8d5","Test greeter — pi skills e2e. The unique suffix c4a8d5 appears in the skill name so a string match in the agent's output proves Pi loaded this skill.","https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Ftests\u002Fresources\u002Fagents\u002Fpi_skills_none\u002Fskills\u002Fpi-e2e-xyz-greet-c4a8d5\u002FSKILL.md",[],[],{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":117,"categories":118,"keywords":119,"publishedAt":19},"01M75ZQXYENVMDKZVHZJ2YWQYT","pi-e2e-xyz-count-d2f6e1","Test counter — pi skills e2e. The unique suffix d2f6e1 appears in the skill name so a string match in the agent's output proves Pi loaded this skill.","https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Ftests\u002Fresources\u002Fagents\u002Fpi_skills_none\u002Fskills\u002Fpi-e2e-xyz-count-d2f6e1\u002FSKILL.md",[],[],{"skillNo":121,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":124,"publishedAt":19},"01M75ZQWBTNBWPCRNQSFAREY74","https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Ftests\u002Fresources\u002Fagents\u002Fpi_skills_list\u002Fskills\u002Fpi-e2e-xyz-greet-c4a8d5\u002FSKILL.md",[],[],{"skillNo":126,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":127,"categories":128,"keywords":129,"publishedAt":19},"01M75ZQSV3KK2J062M1M385Q0W","https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Ftests\u002Fresources\u002Fagents\u002Fpi_skills_list\u002Fskills\u002Fpi-e2e-xyz-count-d2f6e1\u002FSKILL.md",[],[],{"skillNo":131,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":132,"categories":133,"keywords":134,"publishedAt":19},"01M75ZQQ36M8HG82JDYJ6C3H1A","https:\u002F\u002Fgithub.com\u002FZ-57-z\u002Fgameops-agentic-framework\u002Fblob\u002Fmain\u002Ftests\u002Fresources\u002Fagents\u002Fpi_skills_all\u002Fskills\u002Fpi-e2e-xyz-greet-c4a8d5\u002FSKILL.md",[],[]]