# Alwrity: Redefining Content Lifecycle with AI
### 🚀 **ALwrity: Your All-in-One Content Platform** 🌟

![Alwrity Logo](https://github.com/AJaySi/AI-Writer/blob/main/lib/workspace/alwrity_logo.png)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![Streamlit](https://img.shields.io/badge/Streamlit-1.28+-red.svg)](https://streamlit.io/)

> **NOTE**  
> *Alwrity is a comprehensive content lifecycle platform tailored for content creators, digital marketers, and writers — no prior AI knowledge required.*    

## 📋 Table of Contents

- [Overview](#overview)
- [Key Features](#key-features)
- [System Architecture](#system-architecture)
- [Getting Started](#getting-started)
  - [Prerequisites](#prerequisites)
  - [Installation](#installation)
  - [Configuration](#configuration)
- [Usage Guide](#usage-guide)
  - [AI Writers](#ai-writers)
  - [SEO Tools](#seo-tools)
  - [Social Media Tools](#social-media-tools)
  - [Content Planning](#content-planning)
- [API Documentation](#api-documentation)
- [Contributing](#contributing)
- [Roadmap](#roadmap)
- [License](#license)
- [Acknowledgements](#acknowledgements)
---

## 🌟 Overview

Alwrity streamlines every phase of the content lifecycle, from **planning and research** to **personalized content generation**, **SEO audits**, **publishing**, and **analytics**. Our mission is to empower creators with AI-driven tools that simplify content creation while maintaining quality.

The platform integrates state-of-the-art AI technologies to provide a seamless content creation experience:

| **Content Category**     | **Technologies/Models**                   |
|--------------------------|-------------------------------------------|
| Text Generation Models   | OpenAI, Gemini, Anthropic                 |
| Image Creation Tools     | Stability.ai                              |
| Speech-to-Text Systems   | Whisper, AssemblyAI                       |
| AI-Powered Web Research  | Tavily AI, exa AI, Serper.dev             |

---

## 🚀 Key Features

### AI Writer Tools

- **AI Blog Writer**: Generate blog content based on web research
- **AI YouTube to Content Writer**: Transform YouTube videos into written content
- **AI Long Form Content**: Create detailed articles with proper structure
- **AI Story Writer**: Craft engaging narratives and stories
- **AI Email Writer**: Generate professional and business emails
- **AI LinkedIn Post Generator**: Create optimized LinkedIn content
- **AI Product Description Generator**: Write compelling product descriptions

### SEO Tools

- **Rich Snippet Generator**: Create structured data for better SERP visibility
- **On-Page SEO Analyzer**: Evaluate and optimize web pages
- **URL SEO Checker**: Assess URL structure and performance
- **Backlinking Tool**: Discover high-quality backlink opportunities
- **Image Alt Text Generator**: Create accessible image descriptions
- **Meta Description Generator**: Generate SEO-friendly meta descriptions

### Social Media Tools

- **X Tweet Generator**: Create engaging tweets
- **Instagram Caption Generator**: Write compelling Instagram captions
- **Facebook Post Generator**: Develop Facebook-optimized content
- **YouTube Content Tools**: Generate titles, descriptions, and scripts

### Content Planning

- **Content Calendar**: Plan content for weeks or months ahead
- **Blog Image Creation**: Generate images to complement your content
- **Agentic Content Creation**: Use AI agents for specialized content tasks
- **Web Research Integration**: Gather factual information for your content

## 🏗️ System Architecture

Alwrity is built with a modular architecture that enables flexibility and extensibility:

![Architecture Diagram](https://github.com/AJaySi/AI-Writer/docs/architecture/diagrams/high_level_architecture.png)

The platform consists of several key components:

1. **User Interface Layer**: Streamlit-based web interface
2. **Core Services Layer**: AI Writers, Web Research, SEO Tools, Analytics
3. **Data Storage Layer**: Vector Database (ChromaDB), Relational Database (SQLite)
4. **External Integrations Layer**: LLM Providers, Search Providers, Image Generation, Publishing Platforms

For more detailed architecture information, see the [Architecture Documentation](docs/architecture/index.rst).

## Getting Started with ALwrity: "AI at Every Stage of Content Lifecycle."

Alwrity empowers content creators, solopreneurs and digital marketers with cutting-edge tools for keyword research, AI-driven writing, and social media content generation. From creating high-quality copywriting frameworks to crafting engaging YouTube scripts, our platform simplifies every step of your content creation journey.

---
> ![](https://github.com/AJaySi/AI-Writer/blob/main/lib/workspace/keyword_blog.gif)
---

### Option 1: Get Started Now, [Visit alwrity.com](https://www.alwrity.com/ai-writing-tools) 
> [!NOTE] <p>You will find AI content writing tools, which are Free & No-Signup.
> **Note:** Although, this is limited, as is our wallet & Resources.</p>

### Option 2). **For complete AI content creation toolkit**, alwrity offers a local streamlit UI App.
> [!NOTE] <p>
> Its a BYOK model(Bring Your Own Key).
> **Note:** 🗯️ Now, before you run away 🏃💨   
> If you have 💻 Laptop + 🛜 Internet + 10 minutes, you will be generating blogs, articles etc with just few words.
>
> [Step-By-Step: Getting Started for Absolute Begginers](https://www.alwrity.com/post/getting-started-with-alwrity-ai-writer)
>
>[Getting started for Developers](https://github.com/AJaySi/AI-Writer/wiki/Getting-started-with-ALwrity-AI-writer)
>	<details>
>		<summary>See Details</summary>
>

### ![List of all AI Tools & Features of Alwrity](https://github.com/AJaySi/AI-Writer/wiki/Features-of-ALwrity-AI-writer)
---

- ![Generate Content Calender for Months](https://www.alwrity.com/post/automating-content-calendars-with-ai-agents)
- ![Specilized AI writers for every need & platform](https://github.com/AJaySi/AI-Writer/wiki/Features-of-ALwrity-AI-writer)
- ![ALwrity AI SEO Tools](https://github.com/AJaySi/AI-Writer/wiki/ALwrity-AI-SEO-Tools)
- ![ALwrity Web Researcher](https://github.com/AJaySi/AI-Writer/wiki/Alwrity-AI-Web-Research-Details-for-content-writing)

---

## 📝 Usage Guide

### AI Writers

1. **Blog Writer**:
   - Enter your target keywords
   - Select blog type and length
   - Choose whether to include web research
   - Generate and edit your blog content

   ![Blog Writer Demo](https://github.com/AJaySi/AI-Writer/blob/main/lib/workspace/keyword_blog.gif)

2. **Long Form Content**:
   - Provide a detailed topic
   - Select content structure
   - Generate comprehensive content with proper sections
   - Edit and refine as needed

3. **Email Writer**:
   - Select email type (professional, business, etc.)
   - Enter recipient and purpose
   - Generate appropriate email content
   - Customize tone and style

### SEO Tools

1. **Rich Snippet Generator**:
   - Enter your URL or content
   - Select snippet type (FAQ, Product, etc.)
   - Generate structured data
   - Copy and implement on your website

2. **On-Page SEO Analyzer**:
   - Enter your URL
   - Receive comprehensive SEO analysis
   - Get actionable recommendations
   - Implement suggested changes

### Social Media Tools

1. **X Tweet Generator**:
   - Enter topic or keywords
   - Select tweet style
   - Generate engaging tweets
   - Schedule or post directly

2. **YouTube Script Generator**:
   - Enter video topic
   - Select video length and style
   - Generate complete script with sections
   - Export for recording

### Content Planning

1. **Content Calendar**:
   - Enter your niche or industry
   - Select timeframe (weeks/months)
   - Generate content ideas with titles
   - Export to your preferred format

2. **Web Research**:
   - Enter research topic
   - Select research depth
   - Receive comprehensive research results
   - Use in your content generation

---

## How To Personlize ALwrity & Content Generation

> ![](https://github.com/AJaySi/AI-Writer/blob/main/lib/workspace/alwrity_ai_writer.png)
![Click to Read Details of each available features](https://github.com/AJaySi/AI-Writer/wiki/ALwrity-Interface-first-page-explanation)

![Read Alwrity Configuration Options](https://www.alwrity.com/post/know-powerful-alwrity-ai-writer-configuration):
> [!NOTE] <p><em>Use ALwrity UI Sidebar to modify Alwrity behavior for your content needs.</em></p>

---

## Alwrity Features: Power Up Your Content Creation Life cycle ⚡️

**AI Writer Tools:**

| Tool                                  | Description                                                                 |
|---------------------------------------|---------------------------------------------------------------------------|
| AI Blog Writer                        | Generates blog content based on the latest web research on given keywords. |
| AI YouTube to Content Writer        | Transforms content from provided YouTube URLs into written form.           |
| AI Long Form Content                  | Creates extensive and detailed articles.                                   |
| AI Essay Writer                       | Produces lengthy essays on various topics, with room for improvement.        |
| AI Story Writer                       | Constructs narratives and stories based on provided backstories and characters. |
| AI Professional Email Writer           | Generates various types of professional letters.                |
| AI Business Email Writer              | Generate various types of business emails.                        |
| AI Letter Writer                       | Crafts business letters for formal communication.                          |
| AI LinkedIn Blog Post Generator     | Develops blog posts optimized for sharing on LinkedIn.                       |
| AI Content Outline Generator       | Generates outlines based on keywords gathered from web research.               |
| AI Product Description Generator   | Generate product description based on provided keyword.                        |
| AI Google ADs Generator            | Generate Google ads for the provide target keyword.                            |
---
**AI SEO Tools:**

| Tool                                  | Description                                                                 |
|---------------------------------------|---------------------------------------------------------------------------|
| AI SEO - Generate rich snippet from url | Creates structured data for rich snippets (e.g., reviews, recipes) |
| AI Analyze On-Page SEO              |  Evaluate and optimize web pages for SEO best practices to improve rankings.  |
| AI URL SEO Checker                  | Assess URL structure and SEO performance to enhance search engine rankings. |
| AI Backlinking Tool              |   Discover and build high-quality backlinks using AI-powered analysis and recommendations.  |
| AI OpenGraph Tags Generator     | Generate OpenGraph tags to optimize content sharing on social media platforms. |
| AI Image Alt Text Generator         | Automatically generate descriptive alt text for images to improve accessibility and SEO.    |                    
| AI SEO - Optimize/Resize Image   | Compress and resize images to enhance website performance without compromising quality.  |
| AI Blog Title Generator             | Generate blog titles based on provided targeted keyword.                      |
| AI Meta Description Generator       | Generate SEO friendly description on the provided keyword.                   |
| AI FAQs Generator                   | Generate FAQs based on people also asked for from the web research           |
---
**AI Social Tools:**

| Tool                                | Description                                                                 |
|-------------------------------------|-----------------------------------------------------------------------------|
| AI X Tweet Generator                  | Generates catchy tweets based on provided keyword.                          |
| AI Instagram Caption Generation      | Creates engaging captions for Instagram posts.                              |
| AI Facebook Post Generator           | Creates engaging content for Facebook posts.                                |
| AI YouTube Title Generator           | Creates clikable titles for YouTube video.                                  |
| AI YouTube Video Description Generator  | Generate SEO friendly description for YouTube video.                     |
| AI YouTube Script Generator             | Generate complete YouTube video script based on target keyword and audiences |

**AI Content Planning Tools:**

| Tool                                  | Description                                                                 |
|---------------------------------------|---------------------------------------------------------------------------|
| AI Content Planning & Calendar     | Assists in planning and organizing content with a comprehensive calendar.      |
| Create Blog Images                 | Generates images to complement blog content using Stable Diffusion.            |
| Agentic Content Creation           | Explores innovative content creation methods with CrewAI.                      |
| AI Finance Writer                  | Uses ufinance & padnas_ta to write TA report for given stock symbol            |

**AI Web Research Integrations:**

| Tool                                  | Description                                                                 |
|---------------------------------------|---------------------------------------------------------------------------|
| AI Web Researcher                  | Conducts comprehensive web research and analysis using various methods.        |
| Talk to your Docs (WIP)            | Write content from your local documents of any type (multi-modal)               |

**Integrations:**

| Tool                                  | Description                                                                 |
|---------------------------------------|---------------------------------------------------------------------------|
| AI Agents Team                     | Easily create AI Agents team for Content creation & Digital marketing          |
| Wordpress API integration          | Programmatically upload blogs to wordpress website with API keys               |
| Talk to your website               | Crawl your entire website & write content based on its content, Or Not   |
| Content From URLs                  | Provide any URL to create an original, unique content from                     |

---

## Superpowers 🚀 **🧠  Here's what Alwrity can do for you:**

* **Online content Research:** 🔍  Supercharge your blog posts by integrating insights from online research (SERP, Tavily, Metaphor). Say goodbye to AI hallucinations! Tavily AI, Google Search, SERP, Vision AI, and CrewAI web research agents ensure your content is packed with accurate information.
* **Long Form Content Generation:** ✍️  Write essays, stories, and in-depth blogs with web-researched context. No more staring at a blank page!
* **AI Content Planning & Calendar:** 🗓️  Say goodbye to writer's block! Alwrity will give you months' worth of blog title ideas. 

**🌍  Multi-Language Magic:**

* **Multilingual Support:** 🌎  Write content and conduct web research in your language. We support multiple languages and regions (main_config)!

**🧠  Fighting AI Hallucinations:**

* **Fact-Checked Content:**  🙅  We use web-researched context to generate factual content, eliminating the risk of AI hallucinations. 

**🎨  Multimodal Content Mastery:**

* **Text-To-Text, Speech-To-Text, Text-To-Image, Image-To-Text:** 🖼️  Our multimodal suite empowers you to create a variety of content formats.

**🤖  Your Content Creation Crew:**

* **Agentic Content Team:** 🤝  Build your own AI content team with CrewAI! Define their personas, roles, goals, and tasks. (Beta) 

**📸  Visualize Your Content:**

* **Image Generation and Processing:**  ✨  Create stunning images based on your blog content using DALL-E 3 and Stable Diffusion.  Optimize your images for web use.  (FIXME: More Stable Diffusion magic to come!) 

**SEO Mastery:**

* **SEO Optimization:** 📈  Boost your content's visibility. Alwrity generates SEO-friendly titles, meta descriptions, tags, and categories. 

**🤖  Streamlined Content Publishing:**

* **WordPress & Jekyll Integration:**  🚀  Effortlessly generate and upload your content (and media!) to WordPress using its REST API.  Most markdown-based static websites should integrate seamlessly with minimal effort. 


---
> [!NOTE] <p>This toolkit is designed for automated blog management and requires appropriate API keys and access credentials for full functionality. ALwrity will guide your through this process, we selected APIs which offer generous free trials, **you** only need email id & patience.</p>
---

## Standing on Tech-Shoulders of the Giants - (Credits):

- **APIs**:
  - [Exa API](https://exa.ai/): Provides semantic search capabilities for finding similar topics and technologies.
  - [Tavily API](https://tavily.com/): Offers AI-powered web search functionality for conducting in-depth keyword research.
  - [SerperDev API](https://serper.dev/): Enables access to search engine results and competitor analysis data.
  - [YOU.com](https://you.com/): You.com enhances web search, writing, coding, digital art creation, and solving complex problems.
  - [Stability AI](https://stability.ai/): Activating humanity's potential through generative AI. Open models in every modality, for everyone, everywhere.
  - [OpenAI API](https://openai.com/): Powers the Large Language Models (LLMs) for generating blog content and conducting research.
  - [Gemini API](https://gemini.google.com/app): Google powered LLM for natural language processing tasks.
  - [Ollama](https://ollama.com/) : Local, Privacy focused, LLM provider for research and content generation capabilities.
  - [CrewAI](https://www.crewai.com/): Collaborative AI agents framework.
  - [firecrawl](https://www.firecrawl.dev/): Turn websites into LLM-ready data

---

## 📚 API Documentation

Alwrity provides a comprehensive API for programmatic access to its features. The API documentation is available at:

- [API Reference](docs/api/index.rst)
- [API Examples](docs/api/examples.rst)

## 🤝 Contributing

We welcome contributions to Alwrity! Please see our [Contributing Guide](CONTRIBUTING.md) for details on how to get started.

## 🗺️ Roadmap

- [Read Detailed Roadmap Here](Roadmap TBDs/ROADMAP.md)
- [ALwrity Roadmap](docs/roadmap.rst) 

Our development roadmap includes:

- **Short-term (0-3 months)**:
  - Enhanced multi-language support
  - Improved image generation capabilities
  - Additional AI model integrations

- **Medium-term (3-6 months)**:
  - Advanced analytics dashboard
  - Content performance tracking
  - Collaborative editing features

- **Long-term (6+ months)**:
  - NextJS React Alwrity App
  - API-first architecture
  - Enterprise features for teams

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgements

Alwrity stands on the shoulders of giants:

- **APIs**:
  - [Exa API](https://exa.ai/): Semantic search capabilities
  - [Tavily API](https://tavily.com/): AI-powered web search
  - [SerperDev API](https://serper.dev/): Search engine results
  - [YOU.com](https://you.com/): Enhanced web search
  - [Stability AI](https://stability.ai/): Image generation
  - [OpenAI API](https://openai.com/): LLM capabilities
  - [Gemini API](https://gemini.google.com/app): Google's LLM
  - [Ollama](https://ollama.com/): Local LLM provider
  - [CrewAI](https://www.crewai.com/): Collaborative AI agents

## 📞 Support

If you encounter any issues or have questions, please [open an issue](https://github.com/AJaySi/AI-Writer/issues) on GitHub.

---

<p align="center">
  <a href="https://www.alwrity.com">Visit Alwrity.com</a> •
  <a href="https://www.alwrity.com/ai-writing-tools">Try Free Tools</a> •
  <a href="https://github.com/AJaySi/AI-Writer/wiki">Wiki</a>
</p>

---
