Core claim: ALwrity is a contextual content OS: it understands your brand, website, competitors, and channels, then uses that understanding to drive every story, video, podcast, and campaign, with memory and analytics in one place.
🌐 Live Demo • 📚 Docs Site • 📖 Wiki • 💬 Discussions • 🐛 Issues
- Contextual content OS: Ingests your website, competitors, and channels to build a reusable brand brain.
- Multi-surface by design: Blogs, stories, YouTube, podcasts, and video all read from the same understanding.
- Agent-driven flows: Orchestrated research, planning, writing, and optimization instead of one-off prompts.
- Production-ready: JWT/OAuth2 auth, usage tracking, limits, monitoring, and cost awareness built-in.
ALwrity exists for people who care more about context than prompts.
Most tools either drown you in knobs or reset to a blank page every time.
We wanted a system that:
- Remembers what your brand stands for and who you’re speaking to.
- Grounds content in real data (SEO, competitors, web) before it writes.
- Reuses that understanding across every surface instead of duplicating effort.
- One brain, many surfaces: The same insights power blog posts, stories, YouTube scripts, podcast outlines, and video scenes.
- Less tool-juggling: Guided flows replace “copy data between 5 SaaS tools and a spreadsheet”.
- Safer, more factual content: Grounding and citations reduce hallucinations and rewrites.
- On-brand by default: Personas and brand voice settings keep outputs consistent across channels.
- Operational visibility: Scheduler “tasks needing intervention”, alerts, and logs highlight issues before your audience does.
- AI Blog Writer (Phases): Research → Outline → Content → SEO → Publish, with guarded navigation and local persistence (
frontend/src/hooks/usePhaseNavigation.ts). - Story Writer: Premise → Outline → Chapters → Export, with phase navigation (
frontend/src/hooks/useStoryWriterPhaseNavigation.ts). - YouTube Creator Studio: Plan → scenes → avatar → render workflow for YouTube videos (
frontend/src/components/YouTubeCreator). - Podcast Maker / Test Persona: Turn voice + avatar into short videos using the shared video pipeline.
- Video Studio: Multi-module video creation, editing, and transformation (
frontend/src/components/VideoStudio). - SEO Dashboard: Analysis, metadata, and Google Search Console insights (see docs under
docs-site/docs/features/seo-dashboard). - LinkedIn (Factual, Google‑Grounded): Real Google grounding + citations + quality metrics for posts/articles/carousels/scripts (see
frontend/docs/linkedin_factual_google_grounded_url_content.md). - Persona System: Core personas and platform adaptations via APIs (
backend/api/persona.py). - Facebook Persona Service: Gemini structured JSON for Facebook‑specific persona optimization (
backend/services/persona/facebook/facebook_persona_service.py). - Personalization & Brand Voice: Validation and configuration of writing style, tone, structure (
backend/services/component_logic/personalization_logic.py).
See details in the Wiki: Docs Home
- Clone & install
git clone https://github.com/AJaySi/AI-Writer.git
cd AI-Writer/backend && pip install -r requirements.txt
cd ../frontend && npm install- Run locally
# Backend
cd backend && python start_alwrity_backend.py
# Frontend
cd frontend && npm start- Open and create
- Frontend: http://localhost:3000
- API docs (local): http://localhost:8000/api/docs
- Complete onboarding → generate content → publish
- Integrations: Google Search Console (SEO Dashboard), LinkedIn (factual/grounded content).
- AI Models: OpenAI, Google Gemini/Imagen, Hugging Face, Anthropic, Mistral.
- Security: JWT auth, OAuth2, rate limiting, monitoring/logging.
- Reliability: Grounding + retrieval and citation tracking for factual generation.
| Area | Technologies |
|---|---|
| Backend | FastAPI, Python 3.10+, SQLAlchemy |
| Frontend | React 18+, TypeScript, Material‑UI, CopilotKit |
| AI/Research | OpenAI, Gemini/Imagen, Hugging Face, Anthropic, Mistral; Exa, Tavily, Serper (auto provider selection: Gemini default, HF fallback) |
| Data | SQLite (PostgreSQL‑ready) |
| Integrations | Google Search Console, LinkedIn |
| Ops | Loguru monitoring, rate limiting, JWT/OAuth2 |
- Auto‑selection: The backend auto‑selects the provider based on
GPT_PROVIDERand available keys.- Default: Gemini (if
GEMINI_API_KEYpresent) - Fallback: Hugging Face (if
HF_TOKENpresent)
- Default: Gemini (if
- Configure:
GEMINI_API_KEY=...(text + structured JSON; image via Imagen)HF_TOKEN=...(text via Inference API; image via supported HF models)- Optional:
GPT_PROVIDER=geminiorGPT_PROVIDER=hf_response_api
- Text generation:
- Gemini: optimized for structured outputs and fast general generation
- HF: broad model access via the Inference Providers
- Image generation:
- Gemini/Imagen and Hugging Face providers are supported with a unified interface
For module details, see backend/services/llm_providers/README.md.
- Docs Site (MkDocs): https://ajaysi.github.io/ALwrity/
- Blog Writer (phases and UI):
docs-site/docs/features/blog-writer/overview.md - SEO Dashboard overview:
docs-site/docs/features/seo-dashboard/overview.md - SEO Dashboard GSC integration:
docs-site/docs/features/seo-dashboard/gsc-integration.md - LinkedIn factual, Google-grounded content:
frontend/docs/linkedin_factual_google_grounded_url_content.md - Persona Development (docs-site):
docs-site/docs/features/content-strategy/personas.md
For additional pages, browse the docs-site/docs/ folder.
ALwrity generates a core writing persona from onboarding data, then adapts it per platform (e.g., Facebook, LinkedIn). Personas guide tone, structure, and content preferences across tools.
- Core Persona & API:
backend/api/persona.py - Facebook Persona Service (Gemini structured JSON):
backend/services/persona/facebook/facebook_persona_service.py - Personalization/Brand Voice logic:
backend/services/component_logic/personalization_logic.py - Docs (GitHub paths):
- Personas (docs-site): https://github.com/AJaySi/AI-Writer/blob/main/docs-site/docs/features/content-strategy/personas.md
- LinkedIn Grounded Content plan: https://github.com/AJaySi/AI-Writer/blob/main/frontend/docs/linkedin_factual_google_grounded_url_content.md
At a glance:
- Data → Persona: Onboarding + website analysis → core persona
- Platform adaptations: Platform-specific JSON with validations/optimizations
- Usage: Informs tone, content length, structure, and platform best practices
- Docs & Wiki: https://github.com/AJaySi/AI-Writer/wiki
- Discussions: https://github.com/AJaySi/AI-Writer/discussions
- Issues: https://github.com/AJaySi/AI-Writer/issues
- Website: https://www.alwrity.com
MIT — see LICENSE.
Made with ❤️ by the ALwrity team