openclaw-easy/ViralMint
openclaw-easy/ViralMint has 203 GitHub stars and 49 forks. GitHot measured 0 stars in 24 hours and +7 in 7 days. Last checked 2026-11-18 03:04 UTC. Last push 2026-11-15.
計測したスター増加
- 24時間
- 0
- 7日間
- +7
- 15日間
- 履歴を収集中
- 1か月
- 履歴を収集中
期間ごとの純増数です。期間は重複しており、日別の値ではありません。未計測の値は空欄です。スター数は注目度の指標であり、品質の保証ではありません。
概要
Open-source video pipeline (clipper, script-to-video & more) — scout trends, clip long videos, generate captioned shorts, design motion graphics. Local-first, BYOK. AGPL-3.0.
AIREADME.ja.md
オリジナルViralMint
クリエイターのためのオープンソース・ローカルファーストな動画パイプライン
トレンド発掘 → 長尺動画をクリップ → キャプション付きショートを生成 → モーショングラフィックスを設計 → 22のローカルツールで仕上げ。 すべて自分のマシン上で。自分の API キーを使用。間に SaaS なし。テレメトリなし。
クイックスタート • 機能 • 無料で使えるもの • BYOK • コントリビュート

長尺動画を本物のタイムラインでショートに — 元動画のフレームをドラッグし、文の境界にスナップし、あるいは AI に提案させる。トレンド発掘・文字起こし・台本からのストック映像動画生成・モーショングラフィックス・22の編集ツールまで、すべて同じアプリの中で動きます。
手動のクリエイターが十数個のタブとアプリを横断してやっていることを、ViralMint は1つのローカルワークフローとして実行します。 YouTube・TikTok・Douyin を横断してトレンド動画を見つけ、ローカルの Whisper で文字起こし・分析し、長尺動画を公開できるショートに切り分け、好みの AI でオリジナル台本を書き、キャプション付きストック映像動画をレンダリングする。最後に、AI が下書きしたタイトル・説明文・タグ付きの完成 MP4 が手元に残り、そのまま投稿できます。ブラウザから操作するのも、Telegram・WhatsApp・Discord・Slack でチャットするのも自由自在です。
✨ ViralMint を選ぶ理由
| 🔒 100% ローカル | SQLite、ローカル Whisper、ローカル FFmpeg。台本・文字起こし・ダウンロード・生成動画はマシンの外に出ません。 |
| 🔑 BYOK、仲介者なし | 自分の Anthropic / OpenAI / OpenRouter / YouTube / Pexels キーを使用(OpenAI 互換サーバー — Ollama・LM Studio・vLLM など — にも接続可能)。Fernet(AES-128-CBC + HMAC-SHA256)で暗号化して保存し、プロバイダーへ直接送信 — 間に ViralMint のサーバーはありません。 |
| 🤖 チャットのラッパーではなくエージェント | 目的特化型のエージェント群 — Planner、Scout、Download、Analyzer、Generator — を、実際に処理を実行するストリーミング AI チャットがオーケストレーションします。 |
| ✂️ 切る・生成する・設計する | 完成動画への3つの道: 本物のタイムラインで長尺動画からショートを切り出す、台本からキャプション付きストック映像動画を生成する、あるいは映像を一切使わずにモーショングラフィックスを作る。 |
| 📱 スマホから操作 | Telegram・WhatsApp・Discord・Slack でプランナーと双方向チャット — 同じスレッドでジョブ通知も届きます。 |
| 🆓 すぐに無料で使える | ローカル Whisper、Edge TTS(400以上の音声)、ロイヤリティフリー音楽、Pexels ストック、22の内蔵ツール(ほとんどは FFmpeg + Whisper だけで動作) — 重い処理はすべて $0。プラグインする AI のぶんだけ課金されます。 |
実戦仕込み: 毎コミットで 2,900テストの pytest スイート と、実アプリをエンドツーエンドで操作するブラウザハーネスが走ります。AGPL-3.0 — フォークして、改変して、その上でビジネスを構築できます。
🎯 機能
🔍 ScoutYouTube、TikTok、Douyin を横断するマルチプラットフォームのトレンド発掘(さらに動的検索で yt-dlp 対応の任意のサイトにも対応)。AI によるバイラリティスコアリング、Google トレンドの需要シグナル、再生速度分析、外れ値検出(チャンネル基準の3×〜20×)を備えます。 |
🧠 Analyzeローカル Whisper による文字起こし(長尺もクリーンに処理)に加え、AI によるインサイト抽出 — フック、構成、トーン、離脱リスク、推奨タイトル、そのまま実行できる再現プロンプト — をセグメント単位で採点し、具体的な改善提案を添えます。 |
🎬 Generateフルパイプライン: AI 台本 → TTS 音声 → キーワードに合わせた Pexels ストック映像 → フレーズ単位のアニメーションキャプション(CJK / アラビア語 / タイ語対応)→ バランス調整された BGM → AI サムネイル → 完成した MP4。 |
✂️ Clip Studio1本の長尺動画 → 公開できる多数のショートを、本物のタイムライン の上で切り出します。元動画そのもののフィルムストリップをドラッグすると、ハンドルを動かすあいだカットの最初と最後のフレームがそのまま見え、切れ目は文の境界にスナップするので単語の途中から始まることがありません。正確なタイムコードを直接入力しても、番組ノートの時刻を貼り付けても構いませんし、AI に提案させる こともできます — AI のピックは調整も削除もできるブロックとして並び、レンダリングは何も起きません(フック・流れ・価値・トレンド適合・シェアされやすさで採点済み)。急ぐときは Auto-cut: 一度押すだけで全部やり、しかも「何本になるか」を先に伝えます。 |
🎞️ Motion Graphics実写素材をまったく含まない第三の出力: キネティックタイポグラフィ、アニメーションする数値カード、ロワーサード、プロダクト紹介。作りたいものを説明すれば AI が本物のコンポジションを書き、埋め込みのアニメーションスタジオ(タイムライン・レイヤー・インスペクター付き)で仕上げて、すべて自分のマシン上でレンダリング します。オンデマンドインストール — ダウンロードには同梱されていません。 |
🗂️ Library所有するものすべてを一つのファセット表示に: レンダリング成果物、ダウンロード、あらゆるツールの出力、音楽フォルダ。2つの問いに2つのコントロールが対応します — タブはそのファイルが何であるか(動画 / 画像 / 音声 / ファイル)、チップはどこから来たか(作成 / 編集 / ソース)を示すので、ダウンロードした mp3 がどちらか一方を選ぶ必要はありません。ソース別 にまとめれば、ダウンロード1本とそこから作ったすべてが並びます。Activity はどのページからでも開けて、進行中の処理を確認できます。 |
💬 Chatすべてのエージェントをオーケストレーションするストリーミング WebSocket チャット。「料理動画を発掘して」 や 「この URL をダウンロードして」 と言えばそのまま実行。タップできるクイックリプライのチップ、コンポーザーをロックしない追加質問、リロードをまたいで残るリッチな結果カード。 チャットはあなたのライブなパイプラインを読み取り — ダウンロード済みだが未クリップ、生成済みだが未投稿、発掘済みだが未ダウンロード — 頼まれるのを待たずに、最も価値の高い次の一手を1つ提案します。 |
📲 MessagingTelegram・WhatsApp・Discord・Slack でスマホから双方向チャット。どこからでもプランナーに指示し、ジョブが完了したら通知を受け取る — 同じエージェント、異なるトランスポート。 |
⬇️ ユニバーサルダウンローダー内部は yt-dlp — YouTube・TikTok・Bilibili・Instagram・Twitter/X・SoundCloud・Vimeo、その他 1,800以上のサイト に対応。ウォーターマークなし、広告なし、上限なし。 |
🧰 22の内蔵ツール単機能ユーティリティ — キャプション、リフレーム、GIF、速度、トリム、字幕、ウォーターマーク、結合、オートズーム、ミュージックビジュアライザー、ボイスオーバー、さらに AI ヘルパー(翻訳、メタデータ、フック分析、自動チャプター)。ほとんどが FFmpeg + Whisper で100% ローカルに動作 — API キー不要。 それぞれにインラインの結果プレビューが付いています。 |
🆓 API キーなしで動くもの
高価な部分は無料でローカルに動きます。プラグインする AI のぶんだけ課金されます。
| 機能 | 使用技術 | コスト |
|---|---|---|
| 1,800以上のサイトからの動画ダウンロード | yt-dlp | $0 |
| 音声の文字起こし | ローカル faster-whisper | $0 |
| ボイスオーバー(400以上の音声、70以上の言語) | Edge TTS | $0 |
| 単語ごとのアニメーションキャプション | FFmpeg + ASS 字幕 | $0 |
| BGM ライブラリ | ロイヤリティフリーのローカルライブラリ | $0 |
| 効果音の自動配置 | FFmpeg 合成 | $0 |
| Tools: リフレーム、GIF、速度、トリム、ウォーターマーク、結合、オートズーム、ミュージックビジュアライザー、字幕… | FFmpeg + Whisper | $0 |
YouTube / TikTok / Pexels には引き続き無料の API キーが必要です — リンクは BYOK セクション に。
🚀 クイックスタート
前提条件
| ツール | macOS | Linux | Windows |
|---|---|---|---|
| Python 3.11+ | brew install python |
apt install python3.11 |
python.org |
| Node.js 18+ | brew install node |
apt install nodejs npm |
nodejs.org |
| FFmpeg | brew install ffmpeg |
apt install ffmpeg |
ffmpeg.org |
インストールと実行
git clone https://github.com/openclaw-easy/ViralMint.git
cd ViralMint
python -m venv venv && source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env # optional — keys can also be set in the UI
python run.py
初回起動時に、フロントエンドの依存関係をインストールし、SPA をビルドし、API を起動して、ブラウザで http://localhost:16888 を開きます。
📦 インストーラーを使いたい場合: macOS・Windows・Linux 向けのビルド済みアプリは Releases ページ にあります。macOS 版は Apple Silicon(M1 以降)専用です。Intel Mac では上記の手順でソースから実行してください。
💡 まだ API キーがない? 起動後に Settings → AI Provider を開き、Anthropic・OpenAI・OpenRouter のキーを貼り付けてください。OpenRouter は300以上のモデルへの統一ゲートウェイで、1つのキーで Claude・GPT・Gemini・Llama・Mistral を利用できます。自前のサーバーを使う場合は OpenAI-compatible を選び、Base URL(Ollama なら
http://localhost:11434/v1)とモデル名を入力してください。ローカルサーバーならキーは不要です。Edge TTS・Whisper・FFmpeg・yt-dlp はすべて設定不要でオフライン動作します。
ソースからデスクトップアプリをビルド(任意)
ターミナルコマンドよりクリックできるアプリが欲しい場合、自己完結型の PyInstaller パイプラインがこのソースから macOS .dmg・Linux .tar.gz・Windows .zip をビルドします — UI は引き続きブラウザです。
PYTHON_BIN=./venv/bin/python VIRALMINT_VERSION=0.1.0-dev \
bash desktop/scripts/build-app.sh
出力は desktop/release/ に置かれます。初回ビルドは約10〜15分(PyInstaller のバンドルが最も時間のかかる部分です)。スキップ用フラグ、署名・公証の環境変数、スモークテストの手順は desktop/README.md にあります。
🔑 自分のキーを使う (BYOK)
各キーは .env または アプリ内の Settings でユーザーごとに設定できます — 設定されているほうが優先されます。ユーザーごとのキーは保存前に Fernet で暗号化(AES-128-CBC + HMAC-SHA256)されます。キーはプロバイダーへ直接送られ、間に入る ViralMint のバックエンドサーバーはありません。
| 用途 | プロバイダー | 場所 | コスト |
|---|---|---|---|
| AI チャット、台本作成、分析 | Anthropic · OpenAI · OpenRouter · 任意の OpenAI 互換サーバー | console.anthropic.com · platform.openai.com · openrouter.ai/keys · サーバーの Base URL — Settings → AI Provider | 従量課金(ローカルサーバーは無料) |
| YouTube 発掘・コメント・My Channels | YouTube Data API v3 | console.cloud.google.com/apis/credentials — Settings → Service API Keys | 無料 1日1万ユニット |
| ストック映像 | Pexels | pexels.com/api | 無料 |
| プレミアムボイスオーバー(任意) | OpenAI TTS | platform.openai.com | 従量課金 |
| TikTok / Douyin 発掘 | TikHub API(推奨) | tikhub.io | 無料枠あり |
| Telegram / Discord / Slack | Bot トークン | Settings → Messaging | 無料 |
| QR スキャンでペアリング | Settings → Messaging | 無料 |
⚠️ TikTok / Douyin のセッションクッキーによる発掘 も Settings に高度なフォールバックとして用意されていますが、これは各プラットフォームの利用規約に違反しており、そのクッキーのアカウントが、プラットフォームから見て実際に動作しているアカウントとみなされます。そのリスクを明確に受け入れた場合を除き、TikHub API 経路を使用してください。 詳細は LEGAL.md を参照してください。
🏗️ アーキテクチャ
┌────────────────────────────────────────────────┐
│ React 18 + MUI 7 SPA │
│ (served by FastAPI in production) │
│ Chat · Scout · Channels · Library │
│ Stock Video · Clip Studio · Motion Graphics │
│ Tools · Messaging · Settings │
└─────────────────┬──────────────────────────────┘
│ HTTP + WebSocket
▼
┌────────────────────────────────────────────────┐
│ FastAPI · localhost:16888 │
├────────────────────────────────────────────────┤
│ Planner Agent ─── streaming chat + actions │
│ Scout Agent ───── YouTube · TikTok · Douyin │
│ (+ yt-dlp dynamic search) │
│ Download Agent ── yt-dlp (1,800+ sites) │
│ Analyzer Agent ── Whisper + AI insights │
│ Generator Agent ─ Script → TTS → Stock → │
│ Captions → Music → MP4 │
│ Motion Renderer ─ local HyperFrames engine │
│ Messaging ─────── Telegram · WhatsApp · │
│ Discord · Slack │
└─────────────────┬──────────────────────────────┘
│
┌────────────────────────┼─────────────────────────┐
▼ ▼ ▼
┌─────────────────┐ ┌──────────────────────┐ ┌──────────────────┐
│ SQLite local │ │ storage/ on disk │ │ External APIs │
│ (encrypted │ │ videos · audio · │ │ (BYOK, direct) │
│ credentials) │ │ thumbnails · sfx │ │ │
└─────────────────┘ └──────────────────────┘ └──────────────────┘
技術スタック
| レイヤー | スタック |
|---|---|
| バックエンド | Python 3.11+ · FastAPI · SQLAlchemy 2.0 (async) · SQLite · WebSockets |
| フロントエンド | React 18 · Vite · MUI 7 · Zustand · React Router 6 |
| AI (BYOK) | Anthropic Claude SDK · OpenAI SDK · OpenRouter (1つのキーで300以上のモデル) · 任意の OpenAI 互換サーバー(Ollama・LM Studio・vLLM…) |
| 文字起こし | faster-whisper(ローカル、多言語、CPU int8) |
| TTS | Edge TTS(無料)· OpenAI TTS |
| 動画 | Pexels ストック · FFmpeg · Ken Burns 画像フォールバック |
| キャプション | FFmpeg + ASS(単語ごとのハイライトアニメーション) |
| ダウンロード | yt-dlp (1,800+ sites) |
| メッセージング | python-telegram-bot · discord.py · slack-sdk · neonize (WhatsApp) |
| セキュリティ | 保存時の認証情報に Fernet (AES-128-CBC + HMAC-SHA256) |
📸 スクリーンショット
📁 プロジェクト構成
ViralMint/
├── run.py # 🚀 Single entry point
├── launcher.py # System-tray launcher (optional)
│
├── backend/
│ ├── agents/ # Planner, Scout, Download, Analyzer, Generator
│ ├── api/ # REST + WebSocket endpoints
│ ├── core/ # AI client, BYOK key resolver, crypto, WebSocket manager
│ ├── messaging/ # Telegram / WhatsApp / Discord / Slack channels
│ ├── models/ # SQLAlchemy models
│ └── services/ # TTS, video gen, captions, music, yt-dlp, Whisper, …
│
├── frontend/
│ └── src/
│ ├── pages/ # Chat · Channels · Library · Stock Video · Clip Studio · …
│ ├── components/ # Reusable UI (chat, settings, videos, …)
│ ├── hooks/ # WebSocket, settings, jobs, source video
│ └── store/ # Zustand global state
│
├── tests/ # pytest suite (2,900+ tests)
├── storage/ # Downloaded videos, audio, generated output (gitignored)
│
├── requirements.txt
├── .env.example
├── CONTRIBUTING.md
├── SECURITY.md
└── LICENSE # AGPL-3.0
🤝 コントリビュート
プルリクエスト歓迎 — バグ修正、新プラットフォーム、追加のメッセージングチャンネル、パフォーマンス改善、ドキュメント、何でも。ワークフローとハウススタイルは CONTRIBUTING.md を、最初の issue を立てる前に 行動規範 をご確認ください。
- 📋 最近の変更: CHANGELOG.md
- 🐛 バグ報告: issue を作成
- 💡 機能リクエスト: issue を作成
- 🔐 セキュリティ脆弱性: SECURITY.md — 公開 issue は 立てないでください。
📜 ライセンスと利用条件
ViralMint は GNU Affero General Public License v3.0(LICENSE)の下でライセンスされています。
- ✅ 個人利用・商用利用・改変・再配布が無料
- ✅ その上に SaaS を運営してよい
- ⚠️ 配布する場合(または公開ネットワークサービスとして運用する場合)、改変したソースを同じ AGPL-3.0 の条件で共有する必要があります
ViralMint は自分のマシンで動かすツールです。 メンテナーはあなたのコンテンツをホストせず、API 呼び出しをプロキシもしません — すべての操作は、あなた自身のプラットフォームとキーで、あなたが行うものです。発掘やダウンローダーの機能を使う前に LEGAL.md を読み、何が公認されており(YouTube Data API、Pexels)、何が自己責任で(TikTok / Douyin のセッションクッキー発掘)、各プラットフォームの利用規約の下で何に対して責任を負うのかを理解してください。
🙋 セルフホストしたくない?
viralmint.net にホスト版のビルドもあります — 発掘・分析・生成のエンジンは同じで、署名・公証済み、設定する API キーもありません(BYOK の代わりにプリペイドクレジット)。クローズドソースで — 自分でキーやインストールを管理したくない人向けの、異なるトレードオフです。詳しい比較と FAQ: docs/hosted-vs-self-hosted.md。ホスト版でよく使われる入口: YouTube AI クリップ抽出、YouTube 動画ダウンローダー、AI 字幕ジェネレーター、AI 動画ジェネレーター。それ以外は、必要なものはすべてここにあります — 読み進めて python run.py を実行してください。
⭐ ViralMint が役に立ったら、スターを
スターはこのプロジェクトを助ける最大の要素です — コントリビューターを引き寄せ、awesome リストへの掲載資格を解き、他のクリエイターに一見の価値があると伝えます。ワンクリックで完了します。
⭐ openclaw-easy/ViralMint にスター
FastAPI、React、Whisper、FFmpeg、そして大量の非同期 Python で構築。
ウェブサイト: viralmint.net · ソース: github.com/openclaw-easy/ViralMint · ライセンス: AGPL-3.0






