recursive-oss/rec

选用指南

AI 根据 README 整理 · 2026/10/22 07:21:21

使用方式

通过命令行使用，支持启动预配置的 pi 或 OpenCode 环境，也可通过 OpenAI 兼容 API 连接自定义客户端。

查看 README 依据

```bash rec launch pi # preferred rec launch opencode ``` ⚠️ rec is optimized for single-session usage. To run multiple agents at a time, see our [documentation](https://docs.recursive.com/getting-started) for other ways to run our models. This starts our inference server and connects to it automatically. The first run downloads the model and harness. The model server continues to run after you close the terminal. Run `rec stop` to stop it. These harnesses are kept separate from anything on your system. Use `rec exec pi|opencode ARGS` to run their own commands, for example: ```bash

rec exec pi install npm:PACKAGE ``` ### Use your own harness `rec` exposes an OpenAI-compatible chat-completions API. Start the server: ```bash rec serve ``` Keep this terminal open. When `flint is ready.` appears, connect a client from another terminal. To use your own install of pi or OpenCode, run: ```bash rec launch --args pi rec launch --args opencode ``` Each command prints the environment and command line that `rec launch` uses, instead of running it. Replace the harness path with the path to your own harness. The command also points the harness at rec's own settings and

部署要求

需要 Apple Silicon Mac（M4 Pro、M5 Pro 或 M5 Max），至少 48 GB 统一内存，约 30 GB 可用磁盘空间。

查看 README 依据

token throughput across the context lengths shown below on M4 Pro. Use it with pi, OpenCode, or connect your own client through the local API. <p align="center"> <img src=".github/assets/throughput.svg" alt="Flint decode throughput: rec vs. llama.cpp at context lengths from 1K to 252K tokens" width="640"> </p> <p align="center">_{Flint on Apple M4 Pro (48 GB), 4-bit weights, 1K–252K-token prompts and 1,024 output tokens. Five runs per context; prefill excluded.}</p> ## Requirements - Apple Silicon Mac with an M4 Pro, M5 Pro, or M5 Max - At least 48 GB unified memory

- About 30 GB free disk space - [Node.js 22](https://nodejs.org/en/download) and npm for pi ## Install Install using: ```bash curl -fsSL https://raw.githubusercontent.com/recursive-oss/rec/main/install.sh | bash ``` This installs `rec` in `~/.local/bin` and adds it to your PATH for new terminals. All other data lives under `~/.local/share/rec`. ## Usage We find the best performance from our models when paired with the [pi](https://pi.dev/) harness. For convenience, rec provides pre-configured recipes for running pi and [OpenCode](https://opencode.ai) harnesses. Run them using:

已知限制

rec 针对单会话使用优化，多代理并发需参考文档。

查看 README 依据

```bash rec launch pi # preferred rec launch opencode ``` ⚠️ rec is optimized for single-session usage. To run multiple agents at a time, see our [documentation](https://docs.recursive.com/getting-started) for other ways to run our models. This starts our inference server and connects to it automatically. The first run downloads the model and harness. The model server continues to run after you close the terminal. Run `rec stop` to stop it. These harnesses are kept separate from anything on your system. Use `rec exec pi|opencode ARGS` to run their own commands, for example: ```bash