能力标签

🔄 工作流 🐳 Docker 💻 CLI 🔗 REST API 📚 RAG 🖼 视觉 🎙 STT ✨ GPT 🖥 本地 LLM

🛠

AI工具

源内AI

基于 TypeScript · 开源免费，本地部署，数据完全自主可控

英文名：open-genai

⭐ 119 Stars 🍴 9 Forks 💻 TypeScript 📄 NOASSERTION 🏷 AI 8.0分

8.0AI 综合评分

AITypeScriptKeycloak

📺 TG 频道

✦ AI Skill Hub 推荐

经 AI Skill Hub 精选评估，源内AI 获评「强烈推荐」。这款AI工具在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 8.0 分，适合有一定技术背景的用户使用。

📚 深度解析

源内AI 是一款基于 TypeScript 的开源工具，在 GitHub 上收获 0k+ Star，是AI、TypeScript、Keycloak领域中的优质开源项目。开源工具的最大优势在于代码完全透明，你可以审计每一行代码的安全性，也可以根据自身需求进行二次开发和定制。

**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。

**安装与环境准备**
源内AI 依赖 TypeScript 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 TypeScript 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。

**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪源内AI 的版本更新，及时通知重要功能变化。

📋 工具概览

源内AI 是一款基于 TypeScript 开发的开源工具，专注于 AI、TypeScript、Keycloak 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

GitHub Stars

⭐ 119

开发语言

TypeScript

支持平台

Windows / macOS / Linux

维护状态

轻量级项目，按需更新

开源协议

NOASSERTION

AI 综合评分

8.0 分

工具类型

AI工具

Forks

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

开源免费，支持本地部署，数据完全自主可控
活跃的 GitHub 开源社区，持续迭代更新
提供详细文档和使用示例，新手友好
支持自定义配置，灵活适配不同使用环境
可作为基础组件集成进现有技术栈或进行二次开发

🎯 主要使用场景

本地部署运行，保护数据隐私，满足合规要求
自定义集成到现有系统，扩展技术栈能力
作为开源基础组件进行商业化二次开发

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：npm 全局安装
npm install -g open-genai

# 方式二：npx 直接运行（无需安装）
npx open-genai --help

# 方式三：项目依赖安装
npm install open-genai

# 方式四：从源码运行
git clone https://github.com/hirokawaguchi/open-genai
cd open-genai
npm install
npm start

📋 安装步骤说明

访问 GitHub 仓库页面
按照 README 文档完成依赖安装
根据系统环境完成初始化配置
参考官方示例或文档开始使用
遇到问题可在 GitHub Issues 中查找解答

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 命令行使用
open-genai --help

# 基本用法
open-genai [options] <input>

# Node.js 代码中使用
const open_genai = require('open-genai');

const result = await open_genai.run(options);
console.log(result);

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

# open-genai 配置说明
# 查看配置选项
open-genai --config-example > config.yml

# 常见配置项
# output_dir: ./output
# log_level: info
# workers: 4

# 环境变量（覆盖配置文件）
export OPEN_GENAI_CONFIG="/path/to/config.yml"

📑 README 深度解析真实文档完整度 13/100 含工作流图查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

Open GENAI

デジタル庁がオープンソースで公開したガバメント AI「源内（GENAI）」を、 完全ローカル環境 × ローカル LLM（OpenAI 互換 API） で動かすためのプロジェクトです。

バージョン: 現在 v0.3.0（画像生成の源内一本化・アプリピン留め・LGWAN 成果物キャリア配信）。v0.2.1 = セキュリティ・品質保証、v0.2.0 = 自治体・閉域向け拡張、v0.1.0 = ローカル源内化の第一段階。変更履歴は CHANGELOG.md を参照。

免責 / Disclaimer: 本リポジトリは有志による非公式フォークです。デジタル庁とは一切関係がなく、同庁による承認・支援を受けたものではありません。genai-web/ はデジタル庁の digital-go-jp/genai-web（MIT ライセンス）をローカル動作向けに改変して同梱しています（原 LICENSE は genai-web/LICENSE に保持）。デジタル庁オリジナルの genai-ai-api は本リポジトリには含めていません（必要な場合は digital-go-jp/genai-ai-api を別途取得してください）。

ホスト OS / ハードウェアは特定環境に依存しません。macOS (Apple Silicon) でも、 Linux + NVIDIA GPU 機（例: NVIDIA DGX Spark）でも動作します。

源内はもともと AWS / Azure / Google Cloud などのクラウド前提（Amazon Cognito 認証・Lambda・Bedrock 等）で作られているため、そのままではローカルで動きません。本プロジェクトは以下を行うことでローカル完結させます。

認証（SAML）を ローカル完結（backend を SAML SP、Keycloak を SAML IdP として実装）
LLM 呼び出しを OpenAI 互換 API 経由で行う（既定は Ollama の /v1。vLLM / LM Studio / OpenAI など任意の OpenAI 互換サーバに切替可）
クラウド API（チャット履歴・推論ストリーム）を ローカルバックエンド（FastAPI） で代替

[ブラウザ] ──▶ proxy (nginx :80) ──▶ web (源内 Web / Vite)
                  │                    REST + ストリーミング
                  ├──▶ backend (FastAPI) ──▶ OpenAI 互換 LLM（Ollama 等）
                  └──▶ keycloak (/kc)      SAML IdP

本番は docker-compose.prod.yml で TLS(443) 終端。閉域検証は HTTP(80) のみ（docker-compose.verify.yml）。SeaweedFS（8333）は本番 compose ではホスト非公開で、成果物のダウンロードは S3_PUBLIC_ENDPOINT 経由のリバースプロキシを別途用意します（詳細は「成果物ファイル」節）。

変更履歴: CHANGELOG.md（v0.3.0 = 画像生成の源内一本化・アプリピン留め・LGWAN 成果物キャリア配信、v0.2.1 = セキュリティ・品質保証、v0.2.0 = 自治体・閉域向け拡張、v0.1.0 = ローカル源内化）

UX 方針（源内組み込み vs exApp）

クラウド版源内には組み込みの「文字起こし」（/transcribe）と「画像を生成」（/image）があります。 Open GENAI では 機能ごとに入口を分けています（どちらもローカルで動作するよう置き換え済み）。

機能	Open GENAI での入口	理由（UX）
画像生成	源内オリジナル `/image` + ホスト Stable Diffusion	チャット連携・利用履歴・詳細設定など、源内組み込み UX を活かす。初期の SD 専用 exApp は重複のため廃止
文字起こし	exApp（`whisper-app`）	源内 `/transcribe` は Amazon Transcribe + S3 前提のためメニューから除外。ローカル Whisper を exApp として提供

文字起こしで exApp を選んだ理由

源内 /transcribe の主な差分は 話者分離（diarization） だが、ローカルの faster-whisper では Transcribe 相当の話者認識は提供していない。あえて外し、言語指定・タイムスタンプ付き出力・exApp 利用履歴に寄せた
音声は exApp 実行時にコンテナ内で処理され、クラウドへ送信されない（源内 /transcribe のコードはリポジトリに残るが、Open GENAI では /apps/.../whisper から利用する）