{"id":50879456,"url":"https://github.com/muxi-ai/muxi-cpp","last_synced_at":"2026-06-15T12:30:56.547Z","repository":{"id":339665295,"uuid":"1113384691","full_name":"muxi-ai/muxi-cpp","owner":"muxi-ai","description":"Official MUXI SDK for C/C++","archived":false,"fork":false,"pushed_at":"2026-04-08T21:29:27.000Z","size":5827,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"develop","last_synced_at":"2026-04-08T23:17:37.920Z","etag":null,"topics":["ai","ai-agents","cpp","muxi","sdk"],"latest_commit_sha":null,"homepage":null,"language":"C++","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":"2025-12-09T22:51:05.000Z","updated_at":"2026-04-08T21:29:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/muxi-ai/muxi-cpp","commit_stats":null,"previous_names":["muxi-ai/muxi-cpp"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/muxi-ai/muxi-cpp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muxi-ai%2Fmuxi-cpp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muxi-ai%2Fmuxi-cpp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muxi-ai%2Fmuxi-cpp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muxi-ai%2Fmuxi-cpp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/muxi-ai","download_url":"https://codeload.github.com/muxi-ai/muxi-cpp/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muxi-ai%2Fmuxi-cpp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34363537,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai","ai-agents","cpp","muxi","sdk"],"created_at":"2026-06-15T12:30:56.459Z","updated_at":"2026-06-15T12:30:56.536Z","avatar_url":"https://github.com/muxi-ai.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MUXI C++ SDK\n\nOfficial C++ SDK for [MUXI](https://muxi.org) — infrastructure for AI agents.\n\n**Highlights**\n- Modern C++17 with `libcurl` and `nlohmann/json`\n- Built-in retries, idempotency, and typed errors\n- Streaming helpers for chat/audio and deploy/log tails\n\n\u003e Need deeper usage notes? See the [User Guide](https://github.com/muxi-ai/muxi-cpp/blob/main/USER_GUIDE.md) for streaming, retries, and auth details.\n\n## Requirements\n\n- C++17 compiler (GCC 8+, Clang 7+, MSVC 2019+)\n- CMake 3.14+\n- libcurl\n- OpenSSL\n- nlohmann/json\n\n## Installation\n\n### CMake FetchContent\n\n```cmake\ninclude(FetchContent)\nFetchContent_Declare(\n    muxi\n    GIT_REPOSITORY https://github.com/muxi-ai/muxi-cpp.git\n    GIT_TAG v0.20260211.0\n)\nFetchContent_MakeAvailable(muxi)\n\ntarget_link_libraries(your_target PRIVATE muxi)\n```\n\n### Manual Build\n\n```bash\ngit clone https://github.com/muxi-ai/muxi-cpp.git\ncd muxi-cpp\nmkdir build \u0026\u0026 cd build\ncmake ..\nmake\nsudo make install\n```\n\n## Quick Start\n\n### Server Management (Control Plane)\n\n```cpp\n#include \u003cmuxi/muxi.hpp\u003e\n#include \u003ciostream\u003e\n\nint main() {\n    muxi::ServerConfig config;\n    config.url = std::getenv(\"MUXI_SERVER_URL\");\n    config.key_id = std::getenv(\"MUXI_KEY_ID\");\n    config.secret_key = std::getenv(\"MUXI_SECRET_KEY\");\n\n    muxi::ServerClient server(config);\n\n    // List formations\n    auto formations = server.list_formations();\n    std::cout \u003c\u003c formations.dump(2) \u003c\u003c std::endl;\n\n    // Get server status\n    auto status = server.status();\n    std::cout \u003c\u003c \"Status: \" \u003c\u003c status.dump() \u003c\u003c std::endl;\n\n    return 0;\n}\n```\n\n### Formation Usage (Runtime API)\n\n```cpp\n#include \u003cmuxi/muxi.hpp\u003e\n#include \u003ciostream\u003e\n\nint main() {\n    // Connect via server proxy\n    muxi::FormationConfig config;\n    config.formation_id = \"my-bot\";\n    config.server_url = std::getenv(\"MUXI_SERVER_URL\");\n    config.client_key = std::getenv(\"MUXI_CLIENT_KEY\");\n    config.admin_key = std::getenv(\"MUXI_ADMIN_KEY\");\n\n    muxi::FormationClient client(config);\n\n    // Or connect directly to formation\n    muxi::FormationConfig direct_config;\n    direct_config.url = \"http://localhost:8001\";\n    direct_config.client_key = std::getenv(\"MUXI_CLIENT_KEY\");\n    direct_config.admin_key = std::getenv(\"MUXI_ADMIN_KEY\");\n\n    muxi::FormationClient direct_client(direct_config);\n\n    // Chat (non-streaming)\n    nlohmann::json payload = {{\"message\", \"Hello!\"}};\n    auto response = client.chat(payload, \"user123\");\n    std::cout \u003c\u003c response.dump() \u003c\u003c std::endl;\n\n    // Health check\n    auto health = client.health();\n    std::cout \u003c\u003c \"Status: \" \u003c\u003c health.dump() \u003c\u003c std::endl;\n\n    return 0;\n}\n```\n\n## Auth \u0026 Headers\n\n- **Server**: HMAC with `key_id`/`secret_key` on `/rpc/*` endpoints\n- **Formation**: `X-MUXI-CLIENT-KEY` or `X-MUXI-ADMIN-KEY` headers\n- **Idempotency**: `X-Muxi-Idempotency-Key` auto-generated on every request\n- **SDK**: `X-Muxi-SDK`, `X-Muxi-Client` headers set automatically\n\n## Error Handling\n\n```cpp\n#include \u003cmuxi/muxi.hpp\u003e\n\ntry {\n    auto result = server.get_formation(\"nonexistent\");\n} catch (const muxi::NotFoundException\u0026 e) {\n    std::cerr \u003c\u003c \"Not found: \" \u003c\u003c e.what() \u003c\u003c std::endl;\n} catch (const muxi::AuthenticationException\u0026 e) {\n    std::cerr \u003c\u003c \"Auth failed: \" \u003c\u003c e.what() \u003c\u003c std::endl;\n} catch (const muxi::RateLimitException\u0026 e) {\n    std::cerr \u003c\u003c \"Rate limited. Retry after: \" \u003c\u003c e.retry_after() \u003c\u003c \"s\" \u003c\u003c std::endl;\n} catch (const muxi::MuxiException\u0026 e) {\n    std::cerr \u003c\u003c \"Error: \" \u003c\u003c e.what() \u003c\u003c \" (\" \u003c\u003c e.status_code() \u003c\u003c \")\" \u003c\u003c std::endl;\n}\n```\n\n## Configuration\n\n```cpp\nmuxi::ServerConfig config;\nconfig.url = \"https://muxi.example.com:7890\";\nconfig.key_id = \"your-key-id\";\nconfig.secret_key = \"your-secret-key\";\nconfig.timeout = 30;       // Request timeout in seconds\nconfig.max_retries = 3;    // Retry on 429/5xx errors\nconfig.debug = true;       // Enable debug logging\n\nmuxi::ServerClient server(config);\n```\n\n## License\n\nLicensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.\n\n## Links\n\n- [MUXI SDKs](https://github.com/muxi-ai/sdks)\n- [MUXI Documentation](https://docs.muxi.org)\n- [GitHub](https://github.com/muxi-ai/muxi-cpp)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuxi-ai%2Fmuxi-cpp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuxi-ai%2Fmuxi-cpp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuxi-ai%2Fmuxi-cpp/lists"}