<p align="center" <picture <source media="(prefers-color-scheme: dark)" srcset="src/modes/interactive/assets/metis-pixel-mark-white-on-black.png" / <img src="src/modes/interactive/assets/metis-pixel-mark.png" width="144" alt="Metis pixel mark" / </picture </p
<p align="center" <strongEnglish</strong · <a href="README.zh-CN.md"简体中文</a </p
<p align="center" <a href="https://www.typescriptlang.org/"<img alt="TypeScript" src="https://img.shields.io/badge/language-TypeScript-3178C6?logo=typescript&logoColor=white" /</a <a href="https://www.npmjs.com/package/@wholiverhu/metis"<img alt="npm version" src="https://img.shields.io/npm/v/%40wholiverhu%2Fmetis?label=npm&color=CB3837" /</a <a href="https://nodejs.org/"<img alt="Node.js 22.19.0 or newer" src="https://img.shields.io/badge/Node.js-%3E%3D22.19.0-339933?logo=nodedotjs&logoColor=white" /</a <a href="#license"<img alt="MIT License" src="https://img.shields.io/badge/license-MIT-4C1" /</a </p
<p align="center" <strongHelp coding models write better code and finish faster with better context, reusable experience, and verified results.</strong </p
<p align="center" <a href="#why-metis"Why Metis</a · <a href="#better-coding-performance"Coding performance</a · <a href="#what-makes-it-reliable"Reliability</a · <a href="#quick-start"Quick start</a </p
---
Quick start
Choose one interface. Both use the same Metis configuration, models, and sessions.
| Interface | Best for | Requirement | | --- | --- | --- | | Desktop app | Graphical workspace with CLI and server included | Apple silicon Mac (arm64) or Windows (x64) | | CLI | Terminal, scripts, print/JSON, RPC, and SDK integrations | Node.js =22.19.0 and npm |
Desktop app for macOS
- Download the latest Apple silicon .dmg (Metis--macos-arm64.dmg).
- Open it and drag Metis.app into Applications.
- Launch Metis. Node.js is already included.
Desktop app for Windows
The Windows build bundles the full Metis CLI and server runtime. Choose the setup EXE for a normal installation or the ZIP for a portable copy.
Current build: Windows x64. No separate Node.js installation is required.
- Open the latest GitHub Release.
- Download and run Metis--win-x64-setup.exe, or download Metis--win-x64.zip, extract it, and launch Metis.exe from the Metis folder.
- Use the attached .sha256 file to verify your download. If Windows SmartScreen warns about an unknown publisher, continue only when the file came from the official release page.
CLI and terminal
Install Metis, then start an interactive session:
npm install -g --ignore-scripts @wholiver_hu/metis@latest
metis