{"id":45744407,"url":"https://github.com/muxi-ai/hello-muxi","last_synced_at":"2026-05-02T00:04:14.027Z","repository":{"id":340583790,"uuid":"1166704159","full_name":"muxi-ai/hello-muxi","owner":"muxi-ai","description":"A showcase formation for the MUXI registry that demonstrates multi-agent orchestration, MCP integration, SOPs, and real-world side effects — all while explaining MUXI itself.","archived":false,"fork":false,"pushed_at":"2026-03-06T23:37:47.000Z","size":25,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-07T04:37:46.416Z","etag":null,"topics":["formation","muxi"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/muxi-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-25T14:13:35.000Z","updated_at":"2026-03-06T23:37:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/muxi-ai/hello-muxi","commit_stats":null,"previous_names":["muxi-ai/hello-muxi","muxi-ai/muxi-hello-muxi"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/muxi-ai/hello-muxi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muxi-ai%2Fhello-muxi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muxi-ai%2Fhello-muxi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muxi-ai%2Fhello-muxi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muxi-ai%2Fhello-muxi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/muxi-ai","download_url":"https://codeload.github.com/muxi-ai/hello-muxi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muxi-ai%2Fhello-muxi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32307015,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T17:23:19.671Z","status":"ssl_error","status_checked_at":"2026-04-26T17:23:19.195Z","response_time":129,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["formation","muxi"],"created_at":"2026-02-25T16:00:53.706Z","updated_at":"2026-04-26T18:01:07.275Z","avatar_url":"https://github.com/muxi-ai.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hello MUXI\n\nA multi-agent formation that introduces you to MUXI by explaining itself, crawling its own docs, generating files, and posting a real comment on GitHub.\n\n## What It Does\n\nTwo specialist agents coordinated by an Overlord:\n\n| Agent | Role | Tools |\n|-------|------|-------|\n| **MUXI Expert** | Explains MUXI using embedded knowledge and live docs. Can generate PDFs, charts, and other files. | Firecrawl, generate_file |\n| **Community Greeter** | Posts a greeting on the MUXI GitHub repo as proof of real-world action | GitHub |\n\n## Things to Try\n\n| What to say | What happens |\n|-------------|--------------|\n| **\"hi\"** | The Overlord introduces itself and the formation |\n| **\"what is muxi?\"** | The Expert answers using embedded knowledge |\n| **\"tell me about the overlord. use docs at muxi.org\"** | The Expert scrapes muxi.org via Firecrawl, then answers |\n| **\"onboard me\"** or **\"get started\"** | Triggers the onboarding SOP: asks your name, explains MUXI, posts a hello on GitHub, recaps what happened |\n| **\"create a one-page pdf about muxi\"** | The Expert generates an actual PDF file and attaches it to the response using the artifacts module |\n| **\"create a bar chart showing pretend quarterly sales of acme corp\"** | Generates a chart image using the artifacts module |\n\n\n## Prerequisites\n\nYou need API keys for the LLM and the MCP tools. The formation uses Anthropic (Claude Haiku 4.5) as its LLM.\n\n| Secret | What | Where to get it |\n|--------|------|-----------------|\n| `ANTHROPIC_API_KEY` | Anthropic API key (required) | [console.anthropic.com](https://console.anthropic.com) |\n| `FIRECRAWL_API_KEY` | Firecrawl web scraping | [firecrawl.dev](https://firecrawl.dev) (free tier available) |\n| `GITHUB_PAT` | GitHub Personal Access Token | [github.com/settings/tokens](https://github.com/settings/tokens) -- needs `public_repo` scope |\n\nThe `FORMATION_ADMIN_API_KEY` and `FORMATION_CLIENT_API_KEY` are auto-generated during setup for API authentication.\n\n## Quick Start\n\n### 1. Pull from registry\n\n```bash\nmuxi pull @muxi/hello-muxi\ncd hello-muxi\n```\n\n### 2. Set up secrets\n\n```bash\nmuxi secrets setup\n```\n\nYou'll be prompted for the API keys listed above.\n\n### 3. Run locally\n\n```bash\nmuxi up\n```\n\n### 4. Try it\n\nEnter the CLI chat\n```\nmuxi chat\n```\n\nPrompt away :)\n```\n\u003e onboard me\n```\n\nThe formation will ask your name, explain MUXI, post a greeting on GitHub, and show you the live comment URL.\n\n## What the Onboarding SOP Does\n\n1. The Overlord greets you and asks for your name\n2. The **MUXI Expert** gives a concise intro to MUXI (using embedded knowledge + Firecrawl)\n3. The **Community Greeter** posts \"Hello from [your name]!\" on [github.com/muxi-ai/muxi/issues/50](https://github.com/muxi-ai/muxi/issues/50) and returns the comment URL\n4. The Overlord recaps: two agents, two MCPs, one SOP\n\n## Formation Structure\n\n```\nhello-muxi/\n├── formation.afs              # Formation config (Overlord, LLM, server)\n├── SOUL.md                    # Overlord personality and behavior\n├── agents/\n│   ├── muxi-expert.afs        # MUXI explainer (Firecrawl + file generation)\n│   └── community-greeter.afs  # GitHub commenter (GitHub MCP)\n├── sops/\n│   └── onboarding.md          # Guided onboarding walkthrough\n├── knowledge/                 # Embedded docs (overview, FAQ, manifesto)\n├── secrets.enc                # Encrypted secrets\n└── .key                       # Encryption key (never commit)\n```\n\n## Concepts Demonstrated\n\n- **Multi-agent orchestration** -- Overlord routing to specialist agents\n- **MCP integration** -- live tool connections (Firecrawl, GitHub)\n- **File generation** -- agents create PDFs, charts, and documents using sandboxed Python\n- **SOPs** -- structured procedures triggered by user intent\n- **Embedded knowledge** -- agent-specific knowledge base\n- **Real-world side effects** -- a public GitHub comment as proof of action\n\n## Links\n\n- [MUXI Documentation](https://muxi.org/docs)\n- [MUXI GitHub](https://github.com/muxi-ai/muxi)\n- [Agent Formation Standard](https://agentformation.org)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuxi-ai%2Fhello-muxi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuxi-ai%2Fhello-muxi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuxi-ai%2Fhello-muxi/lists"}