{"repo":"bb8ad8/addroid-oss","free":true,"listed":false,"github":"https://github.com/bb8ad8/addroid-oss","clone":"git clone https://github.com/bb8ad8/addroid-oss.git","description":"AdDroid OSS — self-hostable, GitOps-driven Meta ad operations console.","language":"TypeScript","stars":19,"topics":[],"license":"Apache-2.0","category":"self-hosted-apps","readme_excerpt":"AdDroid OSS AdDroid は、Meta 広告運用を GitOps として管理するためのセルフホスト可能な OSS です。 Ads YAML をリポジトリの単一ソースとして扱い、AI が広告案・改善案を生成し、AdDroid が GitHub PR と監査ログで変更を管理し、pg-boss Cron でレポート取得・予算監視・改善提案を 自動実行します。 Status: Initial OSS release candidate. repository checkout では npm install / npm run addroid -- init で セットアップと常駐サービス登録が完結し、その後は addroid を直接使えます。必要に応じて addroid start で 常駐サービスを起動・修復できます。セットアップ後の通常操作は addroid chat に自然文で依頼します。 addroid init は GitHub CLI / PostgreSQL を診断し、不足分は同じ流れで確認しながらセットアップできます。 Meta 広告アカウントを実際に利用するには Meta Access Token が必須です。未設定でも core ヘルスチェックは通りますが、Apply / Activate / レポート取得はできません。 --- デザイン原則 - ローカル完結 : Web UI は 127.0.0.1:3000 のみで listen。public IP / 専用ドメイン / SSL 証明書 / トンネリングサービスを要求しません。 - outbound-only : 全ての外部連携 (GitHub, Meta, Slack, LLM Provider, Image Provider) は AdDroid 側から outbound で起動します。GitHub Webhook は使わず、merged PR 検知は ETag-aware ポーリングで行います。Slack は Socket Mode のみで、request URL を要求しません。 - GitOps : 広告変更は ops repository の Pull Request としてレビュー・マージされ、 全ての操作は監査ログ ( audit logs ) に記録されます。 - AI-assisted, human-approved : AI は提案 (PR) を生成しますが、適用 (Apply) と有効化 (Activate) は分離され、人間の承認 (PR merge / Web UI merge / Slack /adops activate ) を 経由してから Meta に反映されます。 - Apply / Activate split : PR merge から発火する Apply は新規オブジェクトを PAUSED で作成するのみで、ACTIVE 化は監査された有効化経路 (Web UI / Slack / 詳細 CLI) で行います。 - 未設定統合は idle で OK : Slack / Meta / LLM Provider / Image Provider が未設定の状態でも Web UI は 200 OK を返し、Dashboard は idle 表示になります。ただし実際の Meta 広告アカウントを 利用するには Meta Access Token が必須です。 詳細は docs/ARCHITECTURE.md を参照してください。 ","default_branch":null,"files":null,"tree":[],"storefront":"/r/bb8ad8","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/bb8ad8/addroid-oss/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}