Skip to content

Install Qiongli ​

Choose one CLI installation method, then run qiongli install to connect your Host. The current stable version is 2.6.1.

Direct download ​

The standalone program includes research Skills, templates and Lite/Full MCP. No separate Python, Node.js or Rust installation is needed.

PlatformDownload
macOS Apple Silicon (ARM64, macOS 11+)tar.gz
Windows x64zip
Linux x64 (glibc 2.35+)tar.gz
Linux ARM64 (glibc 2.35+)tar.gz

Choose the platform archive under the release's Assets. Source code archives need a build. Binary packages do not cover Intel macOS, Windows ARM64, 32-bit systems or musl Linux. Windows includes the C runtime.

Verify and run ​

Download SHA256SUMS from the same release and compare the SHA-256 for your exact filename. Use shasum -a 256 <filename> on macOS, sha256sum <filename> on Linux, or Get-FileHash <filename> -Algorithm SHA256 in PowerShell.

If the hashes match, extract into a new directory and run there:

sh
./qiongli --version
./qiongli install

In PowerShell, use .\qiongli.exe --version and .\qiongli.exe install. To use the command from any directory, add the extracted directory to your user PATH and open a new terminal.

Package managers ​

Choose one. npm and PyPI include the native executable; Cargo builds from source. Each provides qiongli and ql.

ChannelRequirementInstall command
npmNode.js 18+npm install --global [email protected]
PyPIPython 3.9+; use a virtual environmentpython -m pip install --upgrade "qiongli==2.6.1"
CargoRust 1.97+ and a native linkercargo install qiongli --version 2.6.1 --locked

These commands pin the same stable release. The pip pin also prevents an incompatible platform from silently selecting 1.x. npm prereleases use qiongli@next, which may differ from stable.

Connect your Host ​

sh
qiongli --version
qiongli install
qiongli mcp check

Choose Plugin and your Host, review the file plan and registration, and confirm each step. The Plugin includes Skills, the program and Full MCP.

Open a new Host session. Ask it to list Qiongli tools and call qiongli_config_status. mcp check checks only the local protocol. Then try a research request from the quickstart.

To see what still needs checking, run qiongli doctor, qiongli install inventory, or qiongli provider status. Terminal summaries distinguish local installation, provider configuration and untested session capabilities. Use --text when capturing readable output; --json keeps the structured diagnostics.

Full MCP provides project saving, which still requires a preview and your approval; Lite does not provide project saving. Provider status is offline. A configured provider is not yet a verified connection: an optional qiongli provider test <provider> --confirm-network-request makes one online request. Platforms without credential storage cannot save API keys; public settings remain configurable.

See Plugin setup for Host selection, language, hooks and DeepSeek profiles. Already installed? Follow the upgrade guide.

Qiongli documentation