https://github.com/quarto-dev/q2
q2 is the experimental implementation of Quarto 2 in Rust.
https://github.com/quarto-dev/q2
Last synced: about 1 month ago
JSON representation
q2 is the experimental implementation of Quarto 2 in Rust.
- Host: GitHub
- URL: https://github.com/quarto-dev/q2
- Owner: quarto-dev
- License: mit
- Created: 2025-12-04T17:12:09.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-06-06T05:06:37.000Z (about 2 months ago)
- Last Synced: 2026-06-06T14:04:37.487Z (about 2 months ago)
- Language: Rust
- Homepage: https://q2.quarto.org
- Size: 48 MB
- Stars: 189
- Watchers: 9
- Forks: 11
- Open Issues: 50
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Quarto 2
[](https://deepwiki.com/quarto-dev/q2)
> **Experimental** - This project is under active development. It's not yet ready for production use, and will not be for a while.
This repository is a Rust implementation of the next version of [Quarto](https://quarto.org). The goal is to replace parts of the TypeScript/Deno runtime with a unified Rust implementation.
## Installing
> Release binaries are experimental, like everything else here — they
> exist so the team and early testers don't need a full Rust + Node
> toolchain.
```sh
curl -fsSL https://raw.githubusercontent.com/quarto-dev/q2/main/install.sh | bash
```
On Windows (PowerShell):
```powershell
irm https://raw.githubusercontent.com/quarto-dev/q2/main/install.ps1 | iex
```
The installer downloads the release archive for your platform, verifies
its SHA-256 checksum **and** its Ed25519 signature ([minisign](https://jedisct1.github.io/minisign/),
required — `brew install minisign` / `apt install minisign`), and
installs `q2` to `~/.local/bin` (override with `--dest` or
`Q2_INSTALL_DIR`). The signing public key, pinned in `install.sh`:
```
RWR2A9ILpZX1kVF3Q6uk5TRus8FDM25H2F+KKKHEuqlxv+JJSLyPalvN
```
To verify a manually downloaded archive:
```sh
minisign -Vm q2--.tar.gz -P RWR2A9ILpZX1kVF3Q6uk5TRus8FDM25H2F+KKKHEuqlxv+JJSLyPalvN
```
The trusted comment should name exactly the file you downloaded.
`q2 mcp` (the Quarto Hub MCP server) additionally needs
[Node.js](https://nodejs.org) 24+ at runtime; release binaries come
with the MCP server and quarto-hub.com connection defaults built in, so
no further configuration is needed. Private hub operators can still
point elsewhere via the `QUARTO_HUB_MCP_CLIENT_ID`,
`QUARTO_HUB_MCP_CLIENT_SECRET`, and `QUARTO_HUB_SERVER` environment
variables, which always win over the built-in defaults.
## Building
Requires Rust nightly (edition 2024).
```bash
# Installs nodejs dependencies for the vite/WASM dependencies
npm install
# Build all Rust crates and binaries and test; build hub-client and its TS test suite
cargo xtask verify
# Just build everything instead (use --release for optimized binaries)
cargo xtask build-all
# Run tests (uses nextest)
cargo nextest run
```
## Contributing
We welcome discussions about the project via GitHub issues.
However, the Quarto team will be working on this codebase internally before we're ready to accept outside contributions or make public binary releases/announcements.
Please feel free to use the discussions page for questions and suggestions.
## Status
This is experimental software. All API should be considered unstable and may completely change.
## License
MIT - See [LICENSE](LICENSE) for details.