Genfeed

Genfeed.ai

エージェントが実行できるオープンソースのコンテンツエンジンです。無料でセルフホストするか、Cloud をご利用ください。

ブランドに合った動画、画像、投稿を作成し、確認して接続済みのチャンネルに公開できます。Genfeed 上で作業するか、すでにお使いの AI エージェントを接続できます。

Genfeed が役に立ったら、ほかの人にも見つけてもらえるよう、GitHub でスターを付けてください ⭐。

セルフホスト環境での実際の生成例：プロンプト、生成、承認。約 20 秒。トリミング以外の編集はしていません。

npx @genfeedai/create my-genfeed

Docker Compose v2 と Node.js 24 が必要です。ウィザードがリリースバンドルを検証し、OpenRouter API キーを尋ねた後、起動します。インストールガイド：genfeed.ai/self-hosted · docs.genfeed.ai。

警告

Genfeed は 0.x で、現在も活発に開発されています。破壊的変更があるリリースには、リリース本文にアップグレード時の注意事項が記載されます。セマンティックバージョニングは v1.0.0 から厳格に適用されます。

セルフホスト（Community）、Mac 上で実行（Desktop）、または genfeed.ai のホステッド製品（SaaS）をご利用ください。同じコードを、3 つの デプロイモードで提供しています。

必要条件（Community）

• Docker Engine と Docker Compose v2 プラグイン（docker compose version）、または Docker Desktop が必要です。npx @genfeedai/create と以下のリリースバンドルのどちらにも必要です。
• Node.js 24 以降（>=24）。npx @genfeedai/create の場合のみ必要です。
• ホストでポート 3000（Web）、3010（API）、3011（WebSocket）、3014（MCP）が空いていること。
• 15 GB 以上の空きディスク容量に加えて、メディア、バックアップ、アップグレード用の容量を確保してください。 これは報告されている v0.2.15 のイメージ容量に基づく目安です。システム要件をご覧ください。
• RAM：最低要件は公開されていません。8 CPU／15 GiB でテスト済みです。
• Debian 13 では、 docker-compose パッケージで Compose v2 を利用できます。 Docker CE を使用する場合は、 Docker の apt リポジトリから docker-compose-plugin をインストールしてください。

アプリのログに P1001: Can't reach database server at postgres:5432 と表示される場合は、トラブルシューティングをご覧ください。

クイックスタート（コミュニティ）

ワンコマンド（推奨）：

npx @genfeedai/create my-genfeed

リリースバンドルをダウンロードして検証し、OpenRouter キーの入力を求めてから、スタックを起動します。チェックサム、認証、プロバイダー、アップグレードについては、セルフホスティングガイドをご覧ください。

リリースバンドル（Node.js 不要）： 起動する前に、.env の OPENROUTER_API_KEY に openrouter.ai/keys で取得した有効なキーを設定してください。キーがないと、コンテナは起動時に終了します。

curl -fLO https://github.com/genfeedai/genfeed.ai/releases/latest/download/genfeed-selfhosted.tar.gz
curl -fLO https://github.com/genfeedai/genfeed.ai/releases/latest/download/genfeed-selfhosted.tar.gz.sha256
sha256sum -c genfeed-selfhosted.tar.gz.sha256
tar -xzf genfeed-selfhosted.tar.gz && cd genfeed-selfhosted-v*
cp .env.example .env
# Edit .env: set OPENROUTER_API_KEY to your real OpenRouter key, then:
docker compose --env-file .env -f compose.yml up -d

macOS では、チェックサムの確認に shasum -a 256 -c genfeed-selfhosted.tar.gz.sha256 を使用してください。 API ポートと WebSocket ポートは 127.0.0.1 にバインドされます。リモートブラウザーからアクセスするには、セルフホスティングガイドの説明に従ってリバースプロキシを設定してください。

サーフェス	ローカル URL
Web UI	http://localhost:3000
REST API	http://localhost:3010
MCP サーバー	http://localhost:3014
WebSocket	ws://localhost:3011（エージェントの応答をリアルタイムで受信します。接続可能な状態を保ってください）

バンドルでは、リリース用のイメージが固定され、Prisma のマイグレーションが適用され、ローカルワークスペースが 1 つシードされます。Genfeed Cloud アカウントは不要です。

最初の生成を行うには、次の手順を順番に実行してください。

1. .env の OPENROUTER_API_KEY が有効なキーであることを確認します（npx ウィザードで設定できます）。テキスト生成とエージェントにはこのキーが必要で、値が空またはプレースホルダーの場合、コンテナは起動しません。後から .env を変更した場合は、同じ docker compose up -d コマンドで再作成し、コンテナに新しい値を読み込ませてください。
2. http://localhost:3000/sign-up を開き、メールアドレスとパスワードでアカウントを作成します。サインアップはデフォルトで有効（.env で BETTER_AUTH_ENABLED=true）になっており、メールプロバイダーは不要です。新しいアカウントには、独自の組織とブランドが作成されます。
3. オンボーディングを完了し、タスクまたは生成を開始します。

起動時に OpenRouter キーの形式を確認し、空の値やプレースホルダー値は拒否します。正常に起動しても、プロバイダーの残高やモデルへのアクセスが保証されるわけではありません。Settings → API Keys では、各プロバイダーのキーを保存前にプロバイダーに対して検証します。

コーディングエージェントにインストールを任せる

Genfeed はエージェントによって動作するため、インストールもエージェントに任せられるタスクのひとつです。 次の内容を Claude Code、Codex、Cursor、またはシェルにアクセスできる任意のエージェントに貼り付けてください。

Install Genfeed — the open-source content agent — on this machine, then connect
it to yourself over MCP.

1. Check Docker Engine with Compose v2 is available.
2. Download the Community bundle:
   curl -fLO https://github.com/genfeedai/genfeed.ai/releases/latest/download/genfeed-selfhosted.tar.gz
   curl -fLO https://github.com/genfeedai/genfeed.ai/releases/latest/download/genfeed-selfhosted.tar.gz.sha256
   sha256sum -c genfeed-selfhosted.tar.gz.sha256
   tar -xzf genfeed-selfhosted.tar.gz && cd genfeed-selfhosted-v*
   On macOS, use shasum -a 256 -c for the checksum step.
   cp .env.example .env
3. Ask me for my OpenRouter API key and set it in `.env` as
   `OPENROUTER_API_KEY` (a real key; the container exits at start without
   it). Then start the stack:
   docker compose --env-file .env -f compose.yml up -d
   Wait for http://localhost:3000 to answer. Sign-up is open by default; the
   seed also creates one organization (slug `default`) and brand.
4. For Claude Code, register its dedicated content connector:
   claude mcp add --transport http genfeed --scope user http://localhost:3014/mcp/claude
5. Open /mcp, select genfeed and complete browser OAuth. For other clients,
   configure the standard http://localhost:3014/mcp endpoint and authorize in
   the browser; a scoped API-key fallback is available for those clients.
6. List the Genfeed tools to confirm the connection, then stop.

Reference: https://github.com/genfeedai/genfeed.ai/blob/master/docs/self-hosting.md
Docs index for agents: https://docs.genfeed.ai/llms.txt

すでにホスト版の製品をお使いですか？インストールは省略し、ブラウザーの OAuth で認証してください。 Claude はブランド、下書き、既存のアセット、スケジュール設定、分析に https://mcp.genfeed.ai/mcp/claude を使用します。メディアは Genfeed Playground で作成してください。その他のクライアントは、すべてのツールセットに https://mcp.genfeed.ai/mcp を使用します。

標準の MCP プリセットは承認優先です。エージェントは生成、下書き作成、スケジュール設定を行えますが、公開には人間の承認が必要です。各サーフェスで利用できる機能とその理由については、Agent Surfaceをご覧ください。

実際のセルフホスト版アプリから取得した画像です。バージョンは v0.2.17、サイズは 1440×900、ダークテーマです。 投稿とエージェントとの会話はシード済みのデモコンテンツであり、実際の生成結果ではありません。bun run readme:capture で再生成できます。

エージェント：概要を入力すると、下書きが出力されます。どちらの投稿も、承認待ちとしてPublishingに表示されます。

公開：スケジュール済み、下書き、公開済みの投稿をひとつの一覧で確認できます。

自動化：ビジュアルエディターに表示された、Research to Contentワークフローテンプレート。

機能

• ローカル実行または独自のキーを使用して、画像、動画、テキスト、音声、オーディオを生成
• ビジュアルワークフローの作成、コンテンツライブラリ、ブランド管理、スケジュール設定、公開
• Web アプリ、genfeed CLI、REST API、または MCP 経由のあらゆる AI エージェントから、同じ一連の処理を実行
• Prisma 経由の PostgreSQL、バックグラウンド処理用の Redis/BullMQ
• ホスト版のイメージと同じ AGPL ソースからビルドされた Community Docker ディストリビューション

利用可能な機能は、デプロイモードと設定済みのプロバイダーによって異なります。特定のディストリビューションで機能を利用する前に、 デプロイモードと 実行境界をお読みください。

デプロイモード

モード	対象	入手方法
SaaS	ホスト型のマルチテナント製品	app.genfeed.ai
Community	セルフホスト利用者、単一組織	チェックサム付き GitHub リリースバンドル（上記のクイックスタート）
Desktop	自分の Mac を使う個人クリエイター	desktop-v* タグの署名済み macOS アーティファクト

組織向けの課金機能はすべてのイメージに含まれており、実行時に制御されます （*.genfeed.ai のホスト／セルフホストライセンス）。詳しくは 課金のセクションをご覧ください。 マネージド推論インフラストラクチャと Fleet/LoRA の運用は、この公開リポジトリの範囲外です。

Desktop は macOS を優先しています。モバイル版およびブラウザー／IDE 拡張機能のソースはツリーに含まれていますが、 このリポジトリでは、それらが公開ストアに掲載されているとは謳っていません。

このリポジトリでのエージェントの動作

このリポジトリはエージェントネイティブです。 コードの大半は人間の指示のもとで AI エージェントが作成しており、クローン直後からエージェントが作業を進められるように構成されています。

• AGENTS.md と CLAUDE.md — 型安全性、UI プリミティブ、シリアライザー、テナンシーフィルター、コミット規約など、すべてのエージェント（および人間）が従う運用ルールです。
• CONTEXT.md — 用語集です。各概念の表記を統一し、コード、イシュー、ドキュメント、PR で同じ表記を使用します。
• .agents/ — プロジェクトの永続的なメモリー（ルール、architecture/ADR-*.md にある ADR、仕様）と、アプリの開発・ビルド用スキルが含まれています。MEMORY.md が索引です。リポジトリのルートにある skills/ は別物で、アプリが提供する製品・コンテンツ用スキルです。
• イシューには EARS 形式の受け入れ条件（WHEN … THE SYSTEM SHALL …）が記載されるため、エージェントはイシューを引き受けると、何をもって「完了」とするかを把握できます。トリアージでは不十分な条件を修正し、イシューを差し戻すことはありません。
• shipcode:* ラベルは内部自動化用です。 イシューと PR 上には表示されますが、コントリビューターが付けることはありません。
• PR の本文でエージェントが作成したことを明示し、説明と検証に責任を持つ担当者を記載している場合、エージェントが作成した PR を歓迎します。 エージェントによる作成を明示していない PR はクローズされます。詳しくは CONTRIBUTING.mdをご覧ください。

PR はまず自動パイプラインでレビューされ、その後、メンテナーがレビューします。マージできるのはメンテナーのみです。

アーキテクチャ

Genfeed は、Next.js クライアント、NestJS サーバーワークスペース、PostgreSQL／Prisma による永続化、Redis／BullMQ キューを備えた Bun／Turborepo モノレポです。Community イメージには、Web アプリ、API、ワーカー、ファイル、通知、MCP ランタイムが 1 つのコンテナにまとめられており、Redis が組み込まれています。

apps/
  app/                    Next.js product UI
  server/                 NestJS services and shared server library
  desktop/app/            Electron client (macOS-first release path)
  mobile/app/             Expo/React Native client source
  extensions/browser/app/ Chrome extension source
  extensions/ide/app/     VS Code extension source
packages/                 Shared @genfeedai/* packages
docker/                   Community and hosted image definitions

公開 API は REST／OpenAPI です。GraphQL は、Shopify などの外部連携でのみ使用されます。

技術スタックは宣言済みで、PR ごとに議論するものではありません。構成要素を置き換える場合は、コードを取り込む前に承認済み ADR が必要です（GOVERNANCE.md を参照）。

レイヤー	選択技術	理由
ランタイム＋PM	Bun + Turborepo	インストール、スクリプト、テスト、バンドルに共通のツールチェーンを使用できます
Web	Next.js 16 + React 19	App Router、RSC、および SaaS、Community、Desktop で共通のクライアントを実現します
API	NestJS 11	サービス全体で DI、ガード、テナント／認証の強制を実現します
データ	Prisma 7 + PostgreSQL	単一のスキーマ、型付きクエリ、各リリースに同梱されるマイグレーションを提供します
キュー	Redis + BullMQ	生成、公開、スケジュール設定をバックグラウンドで処理します
認証	Better Auth	セルフホスト可能で組織を認識し、Community ではベンダーアカウントが不要です
品質	Biome、Vitest、Playwright	1 回の実行でフォーマットとリントを実施し、ユニットテストを同じ場所に配置し、配布形態ごとに E2E ティアを用意します
配布	Docker Compose + GHCR	チェックサム付きバンドルをイメージに固定します

詳細：アーキテクチャ · デプロイモード · 実行境界 · エージェント向けインターフェース。

コントリビューション

コントリビューションは任意であり、無報酬です。Genfeed に有償のコントリビューションプログラムはありません。コントリビューションポリシーを参照してください。

このリポジトリの対象者は、セルフホストユーザー、エージェントのコントリビューター、人間のコントリビューターの順です。開発は macOS と Linux でサポートされています（Windows は WSL2 経由）。前提条件は、Node 24、Bun、Compose v2 対応の Docker、C／C++ ツールチェーンと python3（Debian／Ubuntu では sudo apt-get install -y build-essential python3、macOS では xcode-select --install）、および Linux で dev:setup に必要な systemd です。詳細は CONTRIBUTING.mdを参照してください。

bun install && cp .env.example .env.local
bun run env:sync local
docker compose -f docker/local/docker-compose.yml up -d postgres redis
bun run dev:setup                  # once per machine
bun run dev:backend:min            # then, in a second terminal:
bun run dev:app                    # → https://app.genfeed.localhost/

コントリビューターの開発では、Portless HTTPS がデフォルトの方法です。Portless を使用できない場合は、固定ポートを使う dev:debug* コマンドも、任意のデバッグ方法として利用できます。それ以外のすべて（issue フォームと EARS 基準、PR の契約（squash＋conventional title＋issue のリンク）、CLA（GitHub アカウントごと、CLA バージョンごとに 1 回）、エージェントが作成した PR の開示、重点を絞った検証）については、CONTRIBUTING.mdを参照してください。

ガバナンスは、メンテナー 1 名と AI レビューパイプラインで構成されています。 GOVERNANCE.mdを参照してください。ヘルプや質問については、SUPPORT.mdを参照してください。 セキュリティ報告はSECURITY.mdに従って行い、公開 issue には投稿しないでください。

ライセンスと商標

• コード：GNU Affero General Public License v3.0 or later — リポジトリ全体に適用されます
• コントリビューション：Contributor License Agreement （FSFE FLA 2.1：ICLA.md ／ CCLA.md）。CLA Assistant を通じて、GitHub アカウントごと、CLA バージョンごとに 1 回署名します。新しい CLA バージョンは今後のコントリビューションに適用され、過去のコントリビューションには従来の権利が維持されます。
• 名前とロゴ：TRADEMARK.md — ライセンスが対象とするのはコードであり、ブランドではありません

独立して公開されるパッケージやスキルは、パッケージのメタデータで独自のライセンスを宣言できます。

リンク

リポジトリのドキュメント（このツリー内の docs/）は、コントリビューターとセルフホストするユーザー向けです：セルフホスティング、 デプロイモード、 アーキテクチャ、エージェントのインターフェース、 ネイティブ紹介クレジットをご覧ください。 docs.genfeed.ai は、Genfeed を利用するユーザー向けの製品および API ドキュメントです。双方から相互にリンクしており、どちらももう一方の内容を重複して掲載していません。

• ウェブサイト · ホスト版アプリ · 製品ドキュメント
• リリース · プロジェクトボード
• 課題 · ディスカッション
• 料金とクレジット