Skip to content

Repository files navigation

πŸš€ Okara Alternative

An open-source, self-hostable AI CMO β€” bring your own LLM, your own data, your own rules.

License: AGPL v3 Next.js TypeScript PRs Welcome

Features β€’ Quick Start β€’ Architecture β€’ Contributing β€’ License


What this is. An independent, open-source clone of okara.ai β€” a real, working implementation of the same "AI CMO" concept, built from scratch with its own codebase. It is not affiliated with, endorsed by, or derived from Okara's proprietary source. Every feature here is grounded in real crawled data and real API calls β€” no mock data pretending to be real, no invented content dressed up as AI output.

✨ Features

🌐 Bring your own everything

Connect any LLM provider β€” Anthropic, OpenAI, Google Gemini, or a fully local setup via LM Studio, Ollama, or any OpenAI-compatible endpoint. No provider is hardcoded as primary; you pick, per project, what does the work.

πŸ“„ Real strategy documents, not filler text

Five AI-generated documents per project β€” Product Information, Marketing Strategy, Competitor Analysis, Content Strategy, Design Guide β€” every one grounded in an actual crawl of your site (with a real headless-render fallback via Jina AI Reader for JS-heavy SPAs), never inventing a pricing tier, a customer segment, or a hex code it wasn't given. When the page doesn't say it, the document says so.

πŸ” Automatic competitor discovery

Point it at your site and it finds real competitors β€” web-search-grounded (via Tavily) when connected, falling back to the model's own knowledge otherwise β€” but every single candidate is verified with a real fetch before it's saved. A wrong guess just gets dropped, never presented as fact.

πŸ“ˆ Analytics that don't fake it

  • SEO β€” real crawl-based audit, real Google PageSpeed Insights + Core Web Vitals when you connect a key, and an honest crawl-derived substitute (not a placeholder score) when you don't.
  • Technical β€” real server timing (TTFB, TLS handshake, connection), render-blocking resource counts, deterministic content-relevance scoring, on-page checks β€” all computed from the actual response, not simulated.
  • Links β€” real link extraction plus a bounded, explicit reachability check.
  • Site Pages β€” a real multi-page crawl beyond the homepage, with the same JS-render fallback, plus opt-in real PageSpeed scoring per page.
  • GEO β€” a real "AI citation gap" check: does your site actually show up when the live web is searched for queries around your product?

πŸ€– Content agents grounded in your real context

Articles and LinkedIn agents write from your full project context β€” product info, positioning, competitor landscape β€” not generic prompts. Reddit, X, GitHub, and Hacker News agents draft real content too; where a draft can't yet be posted through a live platform API, that's disclosed in the UI rather than silently pretended.

πŸ–₯️ A terminal that tells the truth

Every agent action β€” crawling, generating, discovering, checking β€” streams real status lines to a live terminal log. If something fails, you see the real error, not a spinner that quietly gives up.


πŸš€ Quick Start

Self-host

git clone https://github.com/Kumar2421/okara-alternative.git
cd okara-alternative
npm install
npm run dev

Self-host mode stores project data and provider configuration in local SQLite at data/okara.db.

Hosted platform

The hosted build uses Supabase for authenticated, project-scoped persistence. Configure:

Variable Purpose
NEXT_PUBLIC_SUPABASE_URL Supabase project URL
NEXT_PUBLIC_SUPABASE_ANON_KEY Browser/server Supabase client
SUPABASE_SECRET_KEY Server-only trusted database access

Do not expose SUPABASE_SECRET_KEY to client code.

See docs/production-readiness.md for the production runtime contract and acceptance gate.


πŸ—οΈ Architecture

Next.js 16 (App Router) β€” one app, frontend + API routes, one deploy target
β”œβ”€β”€ app/api/**                 real backend logic
β”œβ”€β”€ lib/llm/*                  provider drivers behind a shared interface
β”œβ”€β”€ lib/domain/**               agents & generators
β”œβ”€β”€ self-host: lib/db.ts        local SQLite persistence
β”œβ”€β”€ platform: Supabase          authenticated Postgres persistence
└── components/**               hand-built UI

The self-host and platform persistence paths are intentionally separate. A hosted platform deployment must not silently fall back to local SQLite.


🀝 Contributing

Issues and PRs are genuinely welcome β€” this is early, opinionated, and built in the open. If you add a feature, hold the same bar the rest of the codebase does: real data or an honest "not available," never a plausible-looking fake.

Contributors

πŸ“œ License

Licensed under the GNU Affero General Public License v3.0. In short: you're free to use, modify, and self-host this β€” but if you run a modified version as a network service, you must make your source available to its users too. See LICENSE for the full text.


Not affiliated with Okara.ai. Built independently as an open alternative.

About

An open-source AI marketing agent platform built as a transparent, customizable alternative to Okara.ai, designed to act as your AI-powered CMO by automating multi-channel growth workflows. It provides modular agents for influencer outreach, Reddit and LinkedIn campaigns, SEO research and content optimization

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages