将生物学问题转化为可审计的代码、图表和结果，在本地使用您选择的 AI 模型。
Inflexa 将自然语言分析请求转换为可运行的代码，在隔离的沙箱中执行，并准确记录所发生的一切，以便结果可以被复现和审计。它完全在你的机器上运行，并支持你选择的模型提供商，包括本地模型以实现完全离线的工作流。
它专为需要可信赖且可重新运行的分析，而不仅仅是聊天窗口中一个答案的科学家、生物信息学家和工程师而构建。
为什么选择 Inflexa
- 本地优先。 你的数据、代码和结果保留在你的机器上。无需账户。
- 构建即可复现。 每次运行都在本地 SQLite 数据库中记录其完整的来源和谱系，支持导出和重放。
- 沙箱执行。 生成的代码在隔离的、无特权的、资源受限的沙箱中运行，默认无网络访问。完整的隔离模型在
SECURITY.md中描述。 - 自带模型。 通过 API 密钥使用任何支持的 LLM 提供商，或端到端离线运行本地模型。
- 完全开源。 CLI 是一个完整的 Apache-2.0 许可产品，而非有限的试用版。参见 开源与商业。
快速开始
使用 Homebrew 安装（macOS，或 x86_64 上的 Linux）：
brew install inflexa-ai/tap/inflexa或者使用安装脚本（支持相同的平台，无需 Homebrew）——它会下载最新版本的发布包，校验其校验和，并安装到 ~/.local/bin：
curl -fsSL https://inflexa.ai/install.sh | bash在 Windows（PowerShell）上：
irm https://inflexa.ai/install.ps1 | iex或从 npm（上述任意平台，Node.js 18+）—— 也可通过 npx @inflexa-ai/inflexa 在不安装的情况下运行：
npm install -g @inflexa-ai/inflexa您只需要本地运行的 Docker —— 分析在沙箱镜像中执行。inflexa CLI 本身是自包含的。
inflexa setup # one-time: connect a model provider, pull the sandbox image, start local services
cd path/to/your/data # go where your data lives
inflexa # launch the TUI更喜欢从源码运行？请参阅 从源码运行。
配置
inflexa setup 将引导你完成模型连接：通过本地代理登录提供商，或将 Inflexa 指向你自己的端点——包括本地模型，以实现完全离线的工作流。它会提示所需内容，并告知你如何提供密钥。
一次性配置分析所需的所有内容：
- 模型连接 — 通过托管的本地代理登录 Claude、OpenAI、Gemini、Qwen 或 iFlow，或指向你自己的端点。
- Postgres + pgvector — 框架运行的数据库，通过 Docker Compose 作为本地容器配置。
- 分析资源配额 — 分析总共可以使用的机器 CPU 和内存份额。
- 嵌入 — 进程内本地模型、你自己的 API 密钥，或关闭。
- 沙箱镜像 — 拉取分析在其中执行的 Docker 镜像（Python，或 Python + R）。
要稍后更改其中任何一项，请运行 inflexa config。
从源码运行
进行开发或自行构建二进制文件，还需要 Bun。CLI 位于 cli/：
git clone https://github.com/inflexa-ai/inflexa.git
cd inflexa/cli
bun install
bun run dev # launch the TUI from source
bun run build # compile a standalone dist/inflexa-<os>-<arch>参见 cli/README.md 获取完整的 CLI 开发者指南，以及 CONTRIBUTING.md 获取开发环境和贡献工作流程。
仓库布局
本仓库是一个包含独立子系统的 monorepo —— 请在您正在修改的子系统内工作；每个子系统都有其自身的依赖项和工具。
| 目录 | 内容 |
|---|---|
cli/ | 本地优先的 TUI/CLI —— 即本产品。包含 SQLite 存储、认证和聊天 UI。从源码运行请从此处开始。 |
harness/ | @inflexa-ai/harness，与主机无关的 agent 框架：agent 循环、持久化工作流、沙箱协议、提供商。执行模型及其设计决策位于此处 —— 参见 harness/CONTEXT.md 和 harness/openspec/specs/ 中的规范。 |
prov-kernel/ | @inflexa-ai/prov-kernel，来源格式内核：PROV 方言词汇表、文档模型以及链/签名原语。框架发出观察钩子；主机拥有其记录器并消费此内核。 |
skills/ | Agent 在运行时加载的共享生物信息学技能包。 |
templates/ | 报告渲染模板。 |
images/ | 沙箱镜像：包含其 Go 执行服务器的基础镜像，以及内置分析包的已发布 python / python-r 变体。 |
scripts/ | 沙箱库存储的构建、验证和发布工具。 |
开源与商业
Inflexa 由 Inflexa, Inc. 开发。本仓库中的开源 CLI 是一个完整的独立产品，遵循 Apache-2.0。一个独立的商业托管平台增加了团队和组织规模的功能，例如协作、治理、托管基础设施和合规支持。其边界及背后的承诺在 COMMERCIAL.md 中描述。
贡献
欢迎各种形式的贡献：代码、示例数据集、文档、验证报告和问题分类。请从 CONTRIBUTING.md 开始。该项目遵循 行为准则 以及 GOVERNANCE.md 中的治理模型。
安全
请勿在公开问题中报告安全漏洞。请遵循 SECURITY.md 中的私有披露流程。
许可证和商标
代码遵循 Apache-2.0 许可。Inflexa 名称和标志是商标，在 TRADEMARK.md 中单独处理：您可以按照许可证使用和分叉代码，但重新分发的分叉版本应重命名。