🚀 ALwrity — AI-Powered Digital Marketing Platform

Create, optimize, and publish high‑quality content across platforms — in minutes, not months.

🌐 Live Demo • 📚 Docs Site • 📖 Wiki • 💬 Discussions • 🐛 Issues

---

Why ALwrity

• AI-first outcomes: Strategy-to-publishing in one flow — strategy, research, creation, QA, and distribution.
• Grounded & reliable: Google grounding, Exa/Tavily research, citation management.
• Secure & scalable: JWT auth, OAuth2, rate limiting, monitoring, subscription/usage tracking.
• Built for solopreneurs: Enterprise-grade capabilities with a fast, friendly UI.
• Comprehensive documentation: Detailed guides, user journeys, and contextual help throughout the platform.

---

Why it matters for creators & marketers

• Reduce complexity of AI tools: Guided flows (research → outline → write → optimize → publish) remove prompt engineering and tool-juggling.
• Save time, ship consistently: Phase navigation and checklists keep you moving, ensuring on-time publishing across platforms.
• Trust the content: Google grounding, retrieval (web/semantic/neural), and citations mean fewer rewrites and safer publishing.
• Stay on-brand and compliant: Personas, tone controls, and rate limits help maintain voice and prevent platform penalties.
• Catch issues early: Scheduler “tasks needing intervention,” alerts, and logs highlight problems before your audience sees them.

---

What’s functional now

• AI Blog Writer (Phases): Research → Outline → Content → SEO → Publish, with guarded navigation and local persistence.
• SEO Dashboard: Analysis, metadata, and Google Search Console insights with comprehensive optimization tools.
• Story Writer: Setup (premise) → Outline → Writing → Export with phase navigation and multimedia integration.
• LinkedIn Writer: Factual, Google‑grounded content with citations and quality metrics for posts/articles/carousels/scripts.
• Instagram Editor: Multi-format content creation with CopilotKit integration for Feed, Stories, and Reels.
• Podcast Maker: AI-powered audio content creation with research, scripting, and voice synthesis.
• Video Studio: Comprehensive video creation with WaveSpeed AI integration and multiple modules.
• YouTube Studio: AI-powered YouTube content planning, scene building, and optimization.
• Content Calendar: AI-powered content planning and scheduling across all platforms.
• ALwrity Researcher: Intent-driven research with multi-source integration and structured outputs.
• Persona System: Core personas with platform-specific adaptations and brand voice management.

See details in the Wiki: Docs Home

---

Quick Start

1. Clone & install

git clone https://github.com/AJaySi/AI-Writer.git
cd AI-Writer/backend && pip install -r requirements.txt
cd ../frontend && npm install

2. Run locally

# Backend
cd backend && python start_alwrity_backend.py
# Frontend
cd frontend && npm start

3. Open and create

• Frontend: http://localhost:3000
• API docs (local): http://localhost:8000/api/docs
• Complete onboarding → generate content → publish

---

Integrations & Security

• 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.

---

Tech Stack

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

---

LLM Providers: Gemini & Hugging Face

• Auto‑selection: The backend auto‑selects the provider based on GPT_PROVIDER and available keys.
  • Default: Gemini (if GEMINI_API_KEY present)
  • Fallback: Hugging Face (if HF_TOKEN present)
• Configure:
  • GEMINI_API_KEY=... (text + structured JSON; image via Imagen)
  • HF_TOKEN=... (text via Inference API; image via supported HF models)
  • Optional: GPT_PROVIDER=gemini or GPT_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.

---

Documentation

• 📖 GitHub Wiki: Complete documentation, guides, and tutorials
• 📚 Docs Site: Interactive documentation with search

📖 Wiki Documentation

• Getting Started
• Configuration Options
• Interface Overview
• AI Web Research
• Blog from Audio
• LLM Models

📖 Internal Documentation

For developers and contributors:

• Frontend Documentation Integration: Guide for implementing contextual help links
• Implementation Guides: Technical specifications and implementation details
• API Documentation: Backend API and service documentation

---

🎯 Recent Updates

• 📚 Enhanced Documentation: Comprehensive GitHub Wiki with detailed feature guides and tutorials
• 🔗 Contextual Help: Integrated documentation links throughout the frontend UI
• 📱 Multi-Platform Support: Expanded content creation for YouTube, Instagram, LinkedIn, and more
• 🎙️ Audio & Video: Podcast Maker and Video Studio with AI-powered creation tools
• 🤖 Advanced AI: WaveSpeed AI integration for cutting-edge content generation

---

Personas (Brief)

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

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

---

Community

• 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

---

License

MIT — see LICENSE.

Made with ❤️ by the ALwrity team