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

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

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.  

Explore the building blocks of Alwrity and contribute to shaping the future of AI-driven content creation.
> **New Release**  
> [*ALwrity AI story writer App*](https://storyme.app.io/) 
Learn more about our journey: [What's Alwrity Up To?](https://www.alwrity.com/post/whats-alwrity-upto)

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

We seamlessly integrate state-of-the-art AI technologies, including:
| **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            |

By bringing these powerful solutions together, Alwrity ensures a streamlined workflow and exceptional output with minimal effort. Get ready to supercharge your content creation process!

---
> ![](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>
>
## Prerequisites

### Windows
- Python 3.10+ (3.12 recommended)
- Microsoft Visual C++ Build Tools 14.0 or greater
  - Install with: `winget install Microsoft.VisualStudio.2022.BuildTools --silent --override "--wait --quiet --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"`
- Rust Compiler
  - Install with: `Invoke-WebRequest -Uri https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe -OutFile rustup-init.exe; ./rustup-init.exe -y`

### Linux
- Python 3.10+ (3.12 recommended)
- C/C++ compiler and development tools
  - Install with: `sudo apt update && sudo apt install build-essential python3-dev`
- Rust Compiler
  - Install with: `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y; source $HOME/.cargo/env`

>	```
>	1). git clone https://github.com/AJaySi/AI-Writer.git
>	2). pip install -r requirements.txt
>	3). streamlit run alwrity.py
>
>	4). Visit Alwrity UI in a Browser & Start generation AI personalized content.
>	```
>
>	### System Dependencies
>	```
>	You can run the install_dependencies.py script to check for system dependencies and assist with installation:
>
>	python install_dependencies.py
>	```
>	This script will help verify that all necessary system dependencies are installed and guide you through the installation process.
>	### Updating to latest Code: (Existing users)
>	```
>	1). Git pull
>	2). pip install -U -r requirements.txt
>	3). streamlit run alwrity.py
>	```
>	</details>
> </p>
---
Still stuck, [Open issue here](https://github.com/AJaySi/AI-Writer/issues) & Someone will bail you out.
> ![Alwrity Documentation is here for more details](https://github.com/AJaySi/AI-Writer/wiki)

### ![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)
- RoadMap - Coming Soon..
- <em>Present Focus: Nextjs react Alwrity App - Coming Soon..</em>

---

## 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

---

<details><summary><h3>Notes from underground:</h3></summary>
	1). Focus is on writing/generating highly unique, SEO optimized blog content.
	2). Models: Openai, gemini, ollama are interesting. Minstral API is also worth exploring. Cohere API is purpose made.
	Focus is getting the prompts right. Shit in, shit out, irrespective of dollars and cutting edge models.
	Pydantically speakng, Due to experimental nature of prompting, its getting expensive soon enough. Gemini is free for now.
	3). Missing frontend: A smart backend will enable a good frontend. WIP, backend. So, frontend; coming soon.
	4).Getting AI agents to 'brainstrom' blog ideas seems more pressing. CrewAI seems more straightforward than autogen.
	5). Too Many APIs floating around: The implementation is using tools that dont depend on API keys and rather scrape them.
	Duh, scraping wont scale, that is GPT vision based scraping will come in handy.
	6). firecrawl is interesting, gpt-researcher is providing local docsqa.
	7). Had to provide streamlit UI as Alwrity's audience arent comfortable with commandline.
	8). Local folder RAG and Chat with your content, website is on the cards.
	9). AI models are better, not sure until when 'Free' APIs will be "Free".
	10). The code is always a mess, lot of changes happening.. 
	11). Focus is to stop making any more AI content tools, but rather revisit & improve user experience & content quality.
	12). To Err is Human & AI....
	13). ....
</details>

---

#### LICENSE
> [!NOTE]<p><em>
> MIT License
>
> Copyright (c) 2024 Alwrity
> 
> Permission is hereby granted, free of charge, to any person obtaining a copy
> of this software and associated documentation files (the "Software"), to deal
> in the Software without restriction, including without limitation the rights
> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
> copies of the Software, and to permit persons to whom the Software is
> furnished to do so, subject to the following conditions:
>
> The above copyright notice and this permission notice shall be included in all
> copies or substantial portions of the Software.
> 
> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
> SOFTWARE.
> </em></p>

## Easy Installation Guide for Content Creators

### Step 1: Install Python 3.11
1. Download Python 3.11 installer:
   - Visit [Python 3.11.6 Download Page](https://www.python.org/downloads/release/python-3116/)
   - Scroll down and click on "Windows installer (64-bit)" 
   - Save the file to your computer

2. Run the installer:
   - Double click the downloaded file
   - ✅ IMPORTANT: Check "Add Python 3.11 to PATH"
   - Click "Install Now"
   - Wait for installation to complete
   - Click "Close"

### Step 2: Install ALwrity
1. Download this project:
   - Click the green "Code" button above
   - Select "Download ZIP"
   - Extract the ZIP file to your desired location

2. Open Command Prompt:
   - Press Windows + R
   - Type "cmd" and press Enter
   - Navigate to the extracted folder:
     ```
     cd path\to\ALwrity
     ```

3. Run the automatic installer:
   ```
   python setup.py install
   ```

### Troubleshooting
If you encounter any issues:
1. Make sure Python 3.11 is installed correctly:
   - Open Command Prompt
   - Type: `python --version`
   - Should show: `Python 3.11.x`

2. Common Issues:
   - If you see "Python is not recognized": Restart your computer
   - If you get package errors: Run `pip install --upgrade pip` first

Need help? [Open an issue](../../issues) and we'll assist you!

## For Developers
If you're a developer or want to contribute:
```bash
# Clone the repository
git clone https://github.com/yourusername/ALwrity.git

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Windows:
.\venv\Scripts\activate
# On Mac/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt
```

# ALwrity - AI Content Writing Assistant

## Quick Start Guide for Non-Technical Users

### Option 1: One-Click Installation (Recommended)
1. Download this project:
   - Click the green "Code" button above
   - Select "Download ZIP"
   - Extract the ZIP file to your desired location (e.g., Desktop)

2. Run the installer:
   - Double-click `install.bat` in the extracted folder
   - If Windows asks for permission, click "Yes"
   - Follow the on-screen instructions
   - Wait for the installation to complete

3. Start ALwrity:
   - Open Command Prompt (Windows + R, type "cmd", press Enter)
   - Navigate to the ALwrity folder:
     ```
     cd path\to\ALwrity
     ```
   - Type `alwrity` and press Enter

### Option 2: Manual Installation
If the one-click installer doesn't work, follow these steps:

1. Install Python 3.11:
   - Visit [Python 3.11.6 Download Page](https://www.python.org/downloads/release/python-3116/)
   - Click "Windows installer (64-bit)"
   - Run the installer
   - ✅ IMPORTANT: Check "Add Python 3.11 to PATH"
   - Click "Install Now"
   - Wait for installation to complete

2. Install ALwrity:
   - Open Command Prompt (Windows + R, type "cmd", press Enter)
   - Navigate to the ALwrity folder:
     ```
     cd path\to\ALwrity
     ```
   - Run the installation:
     ```
     python setup.py install
     ```
   - Follow any on-screen instructions

3. Start ALwrity:
   - In the same Command Prompt window, type:
     ```
     alwrity
     ```
   - Press Enter

### Troubleshooting Guide

#### Common Issues and Solutions:

1. "Python is not recognized"
   - Solution: Restart your computer after installing Python
   - Make sure you checked "Add Python 3.11 to PATH" during installation

2. "Visual C++ Build Tools not found"
   - Solution: Run this command in an administrative PowerShell:
     ```
     winget install Microsoft.VisualStudio.2022.BuildTools --silent --override "--wait --quiet --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"
     ```

3. "Rust compiler not found"
   - Solution: Run these commands in PowerShell:
     ```
     Invoke-WebRequest -Uri https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe -OutFile rustup-init.exe
     ./rustup-init.exe -y
     ```

4. Installation Errors
   - Check the `install_errors.log` file in the ALwrity folder
   - Share the error message with our support team

#### Need Help?
- Open an issue on GitHub
- Join our support community
- Contact our support team

### System Requirements
- Windows 10 or later
- Python 3.11.x
- At least 4GB RAM
- 2GB free disk space

### First-Time Setup
After installation:
1. The first time you run ALwrity, it will ask for your API keys
2. Follow the on-screen instructions to enter your keys
3. Your keys will be saved securely for future use

### Updating ALwrity
To update to the latest version:
1. Download the latest release
2. Run `install.bat` again
3. Follow the on-screen instructions

