# Adeve Adeve is a conversation-based AI Launch Agent and AI project promotion operating system. Adeve turns projects into launch campaigns. Give it a GitHub project, AI website, SaaS, app, Hugging Face demo, course/event, Chrome extension, API, MCP tool, or custom product. It generates strategy, content, tracking links, export packs, approval workflows, analytics/reporting, and optional approval-gated publishing through Postiz. Adeve is not a Postiz replacement. Postiz is an optional real publishing gateway: you can use Postiz Cloud or a self-hosted Postiz instance, while ManualPublisher and MockPublisher remain the default safe paths. Adeve is the project-to-campaign intelligence layer upstream of any configured publisher adapter. Current release: **v0.1.0-demo**. This is a public demo / MVP release for GitHub, recordings, and early tester feedback. It is not a production SaaS. ## Quick Start ```powershell npm install copy .env.example .env npm run db:init npm run demo:all npm run dev ``` Open [http://localhost:3000](http://localhost:3000). Optional verification: ```powershell npm run smoke npm run build ``` ## Showcase Flow 1. Home / Chat Workspace 2. Demo Picker 3. Tool Cards 4. Campaign Canvas 5. Export Center 6. Readiness 7. Settings 8. Connectors 9. Safety 10. Roadmap ## Demo Commands ```powershell npm run demo:github npm run demo:saas npm run demo:app npm run demo:huggingface npm run demo:course npm run demo:all ``` ## Supported Project Types - GitHub repo - AI Website / SaaS - Mobile App - Chrome Extension - Hugging Face Space / Model - API / SDK - AI Agent / MCP Tool - Mini Program - Course / Offline Event - Custom Product ## What the Demo Shows - Chat Workspace for natural-language launch planning - Demo Picker for common product types - Tool Cards for product intake, target analysis, template selection, metric strategy, lead form creation, and campaign creation - Campaign Canvas with target badge, campaign goal, metric plan, lead capture, publisher queue, tracking links, analytics snapshot, and next actions - Export Center for launch brief, manual pack, calendar CSV, app/developer launch packs, lead CSV, and campaign bundle JSON - Readiness, Safety, Settings, Connectors, and Roadmap pages ## Adeve vs Postiz Postiz is social media scheduler and publishing infrastructure. It owns social account connection, OAuth, platform posting, scheduling, media upload, post status, and platform analytics when available. Adeve is the project-to-campaign intelligence layer. It owns Product Intake, Target Type Detection, Launch Template Selection, Campaign Strategy, Multi-platform Content Generation, Lead Capture, Tracking Links, Export Packs, Approval, Analytics/Report, and Postiz Gateway Orchestration. Adeve does not copy Postiz source code, fork the Postiz main application, or package itself as a Postiz clone. It communicates with user-configured Postiz Cloud or self-hosted Postiz through Public API, CLI, or future MCP integration. ## Publishing Modes - MockPublisher for safe local demo publishing - ManualPublisher for copy/open/checklist workflows - Commercial Postiz Gateway for approval-gated real draft/schedule/now publishing after user configuration - optional/manual fallback when external services are missing Real direct platform OAuth publishing is not enabled in this release. ## Commercial Postiz Gateway Commercial V1 treats Postiz as one optional Publisher Adapter, not the only publishing channel. Adeve does not connect directly to platform OAuth; when Postiz is configured, that external Postiz service owns the connected social accounts and platform publishing. Adeve owns campaign content, tracking links, approvals, platform mapping, payload building, queue attempts, status sync, analytics sync, diagnostics, and readiness scoring. Configure: ```powershell POSTIZ_MODE=disabled POSTIZ_BASE_URL= POSTIZ_CLOUD_BASE_URL=https://api.postiz.com POSTIZ_SELF_HOSTED_BASE_URL= POSTIZ_API_URL= POSTIZ_API_KEY= POSTIZ_INTEGRATION_IDS= POSTIZ_DEFAULT_TYPE=draft POSTIZ_AGENT_BIN=postiz ``` Routes: - `/postiz` commercial dashboard - `/postiz/setup` setup wizard - `/postiz/integrations` synced connected channels - `/postiz/mappings` platform mappings and settings resolver - `/postiz/queue` approval-gated publish queue - `/postiz/logs` attempts, posts, analytics, and audit logs Commands: ```powershell npm run demo:postiz-commercial npm run postiz:diagnose ``` Readiness below 80 blocks batch submit. Every external write requires approval. `Publish Now` requires a second `CONFIRM`. ## Documentation - [Demo Release](docs/demo-release.md) - [Recording Script](docs/recording-script.md) - [Known Limitations](docs/known-limitations.md) - [Roadmap](docs/roadmap.md) - [GitHub Release Draft](docs/github-release-v0.1.0-demo.md) - [Promo Pack](docs/promo-pack.md) - [Windows Preview](docs/windows-preview.md) - [Postiz Real Pilot](docs/postiz-real-pilot.md) - [Postiz Commercial Integration](docs/postiz-commercial-integration.md) - [Postiz Platform Settings](docs/postiz-platform-settings.md) - [Postiz Troubleshooting](docs/postiz-troubleshooting.md) - [Commercial Readiness](docs/commercial-readiness.md) - [License Boundary](docs/license-boundary.md) - [Commercial Boundary](docs/commercial-boundary.md) - [Pricing Draft](docs/pricing-draft.md) - [Postiz Real Pilot Checklist](docs/postiz-real-pilot-checklist.md) ## Windows Preview For non-technical testers: ```text start.bat ``` To stop safely: ```text stop.bat ``` See [README-WINDOWS.md](README-WINDOWS.md). ## Pilot Self Promotion Generate an Adeve self-promotion campaign: ```powershell npm run pilot:self ``` It creates content, tracking links, manual publish packs, Postiz-ready jobs for configured mappings, and demo/OPC feedback forms. ## Safety Boundary Adeve does not support spam automation, auto-DM, auto-comment, auto-like, auto-star, simulated login publishing, or bypassing platform risk controls. External publishing remains approval-gated and mock/manual by default.