{"id":50147815,"url":"https://github.com/azmxai/azmx","last_synced_at":"2026-06-03T00:01:19.578Z","repository":{"id":357546336,"uuid":"1236232731","full_name":"AzmxAI/azmx","owner":"AzmxAI","description":"AZMX AI — The sovereign agent platform.","archived":false,"fork":false,"pushed_at":"2026-05-29T01:06:09.000Z","size":170,"stargazers_count":435,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-29T01:24:54.557Z","etag":null,"topics":["ai-agent","ai-terminal","anthropic","byok","claude","local-first","mcp","ollama","openai","react","rust","sovereign-agent","tauri","terminal"],"latest_commit_sha":null,"homepage":"https://azmx.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AzmxAI.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"docs/SUPPORT.md","governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"docs/AGENTS.md","dco":null,"cla":null},"funding":{"custom":["https://azmx.ai/sponsor","https://azmx.ai/pricing"]}},"created_at":"2026-05-12T04:14:20.000Z","updated_at":"2026-05-27T17:45:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AzmxAI/azmx","commit_stats":null,"previous_names":["drvt69talati/azmx-ai-releases","azmxai/azmx-ai-releases","azmxai/azmx"],"tags_count":68,"template":false,"template_full_name":null,"purl":"pkg:github/AzmxAI/azmx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzmxAI%2Fazmx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzmxAI%2Fazmx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzmxAI%2Fazmx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzmxAI%2Fazmx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AzmxAI","download_url":"https://codeload.github.com/AzmxAI/azmx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzmxAI%2Fazmx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33841996,"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-02T02:00:07.132Z","response_time":109,"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-agent","ai-terminal","anthropic","byok","claude","local-first","mcp","ollama","openai","react","rust","sovereign-agent","tauri","terminal"],"created_at":"2026-05-24T06:03:52.800Z","updated_at":"2026-06-03T00:01:19.560Z","avatar_url":"https://github.com/AzmxAI.png","language":"TypeScript","funding_links":["https://azmx.ai/sponsor","https://azmx.ai/pricing","https://github.com/sponsors/AzmxAI"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003c!-- TODO(hero-asset): replace this with the actual logo when assets/ ships. --\u003e\n\u003cimg src=\"https://azmx.ai/assets/logo.png\" width=\"96\" height=\"96\" alt=\"AZMX AI\" /\u003e\n\n# AZMX AI\n\n### The sovereign agent platform.\n\n[![Download latest](https://img.shields.io/github/v/release/AzmxAI/azmx?label=download\u0026style=for-the-badge\u0026color=171717)](https://github.com/AzmxAI/azmx/releases/latest)\n[![Website](https://img.shields.io/badge/website-azmx.ai-171717?style=for-the-badge)](https://azmx.ai)\n[![Discussions](https://img.shields.io/github/discussions/AzmxAI/azmx?style=for-the-badge\u0026color=171717)](https://github.com/AzmxAI/azmx/discussions)\n\n[![License](https://img.shields.io/badge/license-EULA-blue)](LICENSE.md)\n[![Platform](https://img.shields.io/badge/platform-macOS%20%C2%B7%20Linux%20%C2%B7%20Windows-lightgrey)](#install)\n[![Sponsor](https://img.shields.io/github/sponsors/AzmxAI?label=sponsor)](https://github.com/sponsors/AzmxAI)\n\n\u003c/div\u003e\n\n\u003c!--\n  TODO(demo-gif): record a 6–10 second screen capture of the agent doing something\n  undeniable — e.g. \"explain the last error\", \"/init\" a fresh repo, or running a\n  parallel sub-agent against a real diff. Save as assets/demo.gif (\u003c=4 MB) and\n  uncomment the line below. This is the single highest-leverage change in the\n  whole repo for repo-visit → star conversion.\n--\u003e\n\u003c!-- \u003cp align=\"center\"\u003e\u003cimg src=\"assets/demo.gif\" alt=\"AZMX AI in action\" width=\"720\" /\u003e\u003c/p\u003e --\u003e\n\n---\n\n## Install\n\n```bash\n# macOS — Homebrew (live now via our tap; in homebrew-cask review)\nbrew install --cask AzmxAI/azmx/azmx\n\n# macOS / Linux — one-line installer (live)\ncurl -fsSL https://azmx.ai/install | sh\n\n# Windows — winget (manifest submitted to microsoft/winget-pkgs; live after review)\nwinget install AzmxAI.AZMX\n```\n\nOr grab a signed installer for your platform from the **[latest release](https://github.com/AzmxAI/azmx/releases/latest)**:\n\n| Platform | File |\n| --- | --- |\n| macOS (Apple Silicon) | `AZMX.AI_\u003cversion\u003e_aarch64.dmg` |\n| macOS (Intel) | `AZMX.AI_\u003cversion\u003e_x64.dmg` |\n| Linux | `AZMX.AI_\u003cversion\u003e_amd64.AppImage`, `.deb`, or `.rpm` |\n| Windows | `AZMX.AI_\u003cversion\u003e_x64_en-US.msi` or `*_x64-setup.exe` |\n\nDetailed walkthrough per platform: **[SETUP.md](SETUP.md)**.\n\n---\n\n## Why AZMX\n\n- **Your code stays on your machine.** AZMX never proxies AI requests through our servers. Your prompts go directly from your device to whichever provider you chose, or to a local model. We don't sit in the middle — and we can't.\n- **Free local AI without an API key.** One-click Ollama setup. Curated coding models (Qwen2.5-Coder, Granite Code, Llama, all Apache 2.0). Your code never leaves the device.\n- **Or BYOK any major provider.** OpenAI, Anthropic, Google, Groq, xAI, Cerebras, DeepSeek, NVIDIA NIM, Azure OpenAI, any OpenAI-compatible endpoint. Pick whichever, switch any time.\n- **Per-call agent approval.** The agent asks before it writes a file or runs a shell command. Configurable from Permissive to Paranoid (typed confirmation for destructive ops).\n- **Hash-chained, tamper-evident audit log.** Every tool call recorded locally. Export to your SIEM on the paid tiers.\n- **Real terminal, real editor, real file explorer.** xterm.js terminal, CodeMirror editor with vim mode + inline AI autocomplete, file tree with git badges. Not a marketing page that calls itself \"the future of terminals.\"\n- **MCP-native.** 17-server curated catalog (GitHub, GitLab, Kubernetes, Postgres, SQLite, Redis, Slack, Drive, …). Add your own in one JSON file.\n- **~10\u0026nbsp;MB installer. Native. No Electron.** Cold-start under a second. No telemetry, no account, no email-required-to-use.\n\n\u003e The application source is proprietary. **This repository publishes release artifacts and user-facing docs** — installers, the auto-updater manifest, and the community contribution surfaces (skills, agents, MCP servers, snippets, translations). Source contributions land upstream and ship to you via the auto-updater.\n\n---\n\n## First-run in under 3 minutes\n\n1. Open AZMX AI.\n2. The first-run tour appears. On step **\"Free local AI\"**, click **Set up local AI**.\n3. AZMX walks you through installing [Ollama](https://ollama.com) (~150 MB).\n4. Pick **Qwen2.5-Coder 7B** (default — ~4.7 GB, Apache 2.0). The pull streams in-app.\n5. When the bar turns green, the AI panel is live. Ask anything.\n\nPrefer BYOK? Skip step 2's button and use the BYOK step instead. Both paths land at a working composer.\n\n---\n\n\u003ca id=\"extend-azmx\"\u003e\u003c/a\u003e\n\n## 🛠 Extend AZMX\n\n**Your contribution ships to every AZMX user worldwide on next release.** No CLA. You keep copyright. You grant a permissive license. The bundled distribution gets richer every month because of community work.\n\nFive surfaces, every one of them a single Markdown (or JSON) file:\n\n| Build a … | What it is | Where to start |\n|---|---|---|\n| 🤖 **Skill** | A discipline the agent loads on demand to act like a domain expert (e.g. \"Postgres query review\"). One Markdown file. | [`skills/`](skills/) → [`SKILL_AUTHORING.md`](guidelines/SKILL_AUTHORING.md) |\n| 🧑‍🚀 **Sub-agent** | A specialist the main agent delegates to, with bounded tools + predictable output (e.g. `test-writer`, `migration-planner`). | [`agents/`](agents/) → [`AGENT_AUTHORING.md`](guidelines/AGENT_AUTHORING.md) |\n| 🔌 **MCP connector** | A new tool the agent can call — bridge to your service, your data, your internal CLI. | [`mcp-servers/`](mcp-servers/) → [`MCP_AUTHORING.md`](guidelines/MCP_AUTHORING.md) |\n| ✨ **Snippet** | A pre-baked prompt template accessible via `#name` in the composer. | [`snippets/`](snippets/) → [`SNIPPET_AUTHORING.md`](guidelines/SNIPPET_AUTHORING.md) |\n| 🌍 **Translation** | The onboarding card in your language — 5 seeded, ~10 priority next. | [`TRANSLATIONS.md`](guidelines/TRANSLATIONS.md) |\n\n**Plus:** add a [recipe](docs/RECIPES.md) to the cookbook, fix a doc, or [showcase](guidelines/SHOWCASE.md) someone else's work.\n\nEvery contributor gets credit in release notes. Featured contributors get a complimentary Pro license; repeat featured contributors get Teams. **[Read the principles →](guidelines/README.md)**\n\n---\n\n## 📦 Official npm packages\n\nTwo MIT-licensed packages ship under the [`@azmxailabs`](https://www.npmjs.com/org/azmxailabs) npm scope. Use them to make your AI assistant aware of AZMX, or to build your own approval-gated agent with the same primitives AZMX uses internally.\n\n| Package | What it does | Install |\n|---|---|---|\n| **[`@azmxailabs/mcp`](packages/mcp)** [![npm](https://img.shields.io/npm/v/@azmxailabs/mcp.svg?label=npm\u0026color=171717)](https://www.npmjs.com/package/@azmxailabs/mcp) | Official Model Context Protocol server. Drop it into Claude Desktop, Claude Code, Cursor, Windsurf, Continue, OpenAI Codex CLI, Cline, or any other MCP client — and the assistant gains grounded, authoritative knowledge about AZMX (pricing, BYOK providers, security posture, comparisons, install steps, latest release). | `npx -y @azmxailabs/mcp` |\n| **[`@azmxailabs/agent-sdk`](packages/agent-sdk)** [![npm](https://img.shields.io/npm/v/@azmxailabs/agent-sdk.svg?label=npm\u0026color=171717)](https://www.npmjs.com/package/@azmxailabs/agent-sdk) | TypeScript SDK that ships the four primitives behind AZMX as standalone, dependency-free modules — **approval gate, deny-list, hash-chained audit log, BYOK provider router**. Build your own agent (CI script, CLI, desktop app, server) with the same security posture AZMX has, none of the UI. | `npm install @azmxailabs/agent-sdk` |\n\n**Step-by-step walkthrough for either package:** **[docs/DEVELOPER-GUIDE.md](docs/DEVELOPER-GUIDE.md)**\n\n**Full reference docs on the website:**\n- MCP server (per-client setup recipes, tool/resource/prompt inventory, examples): **[azmx.ai/docs#azmxai-mcp](https://azmx.ai/docs#azmxai-mcp)**\n- Agent SDK (concepts, full API, recipes, production checklist): **[azmx.ai/docs#agent-sdk](https://azmx.ai/docs#agent-sdk)**\n\n**Source:** [`packages/`](packages/) — pure TypeScript, Node ≥ 18, ESM, MIT.\n\n---\n\n## Documentation\n\n### Get started\n| | |\n| --- | --- |\n| **[SETUP.md](SETUP.md)** | Install per platform · first-run setup |\n| **[MANUAL.md](MANUAL.md)** | Full feature reference — every panel, every shortcut |\n| **[FAQ.md](FAQ.md)** | Common questions on privacy, licensing, performance, models |\n| **[CHANGELOG.md](CHANGELOG.md)** | Release notes (per-version detail on the releases page) |\n\n### Reference\n| | |\n| --- | --- |\n| **[docs/TIERS.md](docs/TIERS.md)** | What's in Free / Pro / Teams / Enterprise |\n| **[docs/MODELS.md](docs/MODELS.md)** | Supported AI providers · BYOK · local models |\n| **[docs/CONNECTORS.md](docs/CONNECTORS.md)** | The bundled MCP catalog · custom + workspace MCP |\n| **[docs/AGENTS.md](docs/AGENTS.md)** | What the agent can + can't do · approval gates · audit log |\n| **[docs/KEYBINDINGS.md](docs/KEYBINDINGS.md)** | Every shortcut, by category |\n| **[docs/RECIPES.md](docs/RECIPES.md)** | Workflow cookbook — copy + adapt |\n| **[docs/GLOSSARY.md](docs/GLOSSARY.md)** | Terms you'll see across the docs |\n| **[docs/ROADMAP.md](docs/ROADMAP.md)** | What we're working on |\n\n### Policies + posture\n| | |\n| --- | --- |\n| **[SECURITY.md](SECURITY.md)** | Vulnerability reporting · what's protected |\n| **[PRIVACY.md](PRIVACY.md)** | What we collect (nothing, by default) · what lives where |\n| **[LICENSE.md](LICENSE.md)** | EULA pointer · third-party notices · trademarks |\n| **[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)** | How we behave on this project |\n| **[CONTRIBUTING.md](CONTRIBUTING.md)** | How to engage with this repo |\n| **[docs/COMPLIANCE.md](docs/COMPLIANCE.md)** | SBOM · SOC 2 · DPA · FIPS · PIV/CAC |\n| **[docs/TELEMETRY.md](docs/TELEMETRY.md)** | What gets sent (nothing, by default) |\n| **[docs/AIRGAPPED.md](docs/AIRGAPPED.md)** | Run AZMX with zero outbound |\n\n### Operate\n| | |\n| --- | --- |\n| **[docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)** | Problem → fix, by surface |\n| **[docs/DATA_PORTABILITY.md](docs/DATA_PORTABILITY.md)** | Export · backup · move between machines |\n| **[docs/UNINSTALL.md](docs/UNINSTALL.md)** | Clean removal per platform |\n| **[docs/SUPPORT.md](docs/SUPPORT.md)** | Where to go for what |\n\n### Build with us\n| | |\n| --- | --- |\n| **[skills/](skills/)** | Community skills the agent can load (`load_skill(\"…\")`) |\n| **[agents/](agents/)** | Community sub-agents the main agent delegates to |\n| **[mcp-servers/](mcp-servers/)** | Community MCP connector manifests |\n| **[snippets/](snippets/)** | Community prompt snippets (`#name` in the composer) |\n| **[guidelines/](guidelines/)** | Authoring standards for every contribution kind |\n| **[guidelines/SHOWCASE.md](guidelines/SHOWCASE.md)** | Featured community contributions |\n| **[packages/](packages/)** | Official npm packages — `@azmxailabs/mcp` + `@azmxailabs/agent-sdk` |\n| **[docs/DEVELOPER-GUIDE.md](docs/DEVELOPER-GUIDE.md)** | Step-by-step developer walkthrough for both npm packages |\n\n---\n\n## Auto-updates\n\nAZMX checks for updates on launch. New versions land via the in-app updater — no need to revisit this page once you're installed. Signed via a public minisign key bundled with the app.\n\n---\n\n## ⭐ Star this repo\n\nIf AZMX saves you time, a star helps two things:\n\n1. **Other developers find it.** GitHub stars are the single biggest discovery signal for dev tools.\n2. **We know what to keep building.** Every star tells us \"this is the kind of tool worth maintaining.\"\n\nIt costs you one click and supports a small team trying to build the AI terminal we wanted for ourselves. Thank you 🙏\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/AzmxAI/azmx/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/AzmxAI/azmx?style=social\" alt=\"Star history\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Featured by\n\n\u003c!--\n  Press / podcast / video mentions land here as they happen. Add as logo links\n  when real coverage drops — keep it sparse and credible (no \"as seen on\" walls\n  with 50 unverified logos).\n--\u003e\n\n*(This space will fill in as AZMX is covered. [Tell us if you wrote about AZMX →](https://github.com/AzmxAI/azmx/discussions/new?category=show-tell))*\n\n---\n\n## License\n\n## Support\n\n- **Manual / FAQ**: see the links above.\n- **Bugs**: open an issue against this repository — include OS, AZMX version, and steps to reproduce.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazmxai%2Fazmx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazmxai%2Fazmx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazmxai%2Fazmx/lists"}