Content Calendar, Content Gap Analysis, and Content Optimization

2025-05-27 09:15:08 +05:30
parent 4049d19787
commit 889021c078
100 changed files with 18504 additions and 1251 deletions
--- a/Started/Option_1_Windows_Quick_Install/README.md
+++ b/Started/Option_1_Windows_Quick_Install/README.md
@@ -0,0 +1,248 @@
+## 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
+
+# ALwrity Windows Installer Guide (`install_alwrity.bat`)
+
+---
+
+## What is `install_alwrity.bat`?
+`install_alwrity.bat` is a fully automated installer for ALwrity on Windows. It is designed for non-technical users and will set up everything you need with minimal input.
+
+---
+
+## What Does It Do?
+- Checks for administrator rights and guides you if not running as admin.
+- Checks if Python 3.11 is installed. If not, it downloads and launches the installer for you.
+- Checks for Visual C++ Build Tools and Rust compiler. If missing, it downloads and launches their installers.
+- Creates a virtual environment for ALwrity.
+- Activates the environment and upgrades pip.
+- Installs all required Python packages and ALwrity itself.
+- Shows you how to start ALwrity after installation.
+
+---
+
+## Prerequisites
+- **Windows 10 or later**
+- **Internet connection** (to download Python and dependencies)
+- **At least 4GB RAM**
+- **2GB free disk space**
+
+---
+
+## Step-by-Step Instructions
+
+### 1. Download ALwrity
+- Download the ALwrity ZIP file from GitHub.
+- Right-click the ZIP file and select "Extract All..." to unzip it.
+- Open the extracted folder.
+
+### 2. Run the Installer
+- Right-click `install_alwrity.bat` in the `Getting Started` folder and select "Run as administrator".
+- If Windows asks for permission, click "Yes".
+- Follow the on-screen instructions:
+  - If Python 3.11, Visual C++ Build Tools, or Rust are missing, the installer will download and launch their installers for you. Complete each installation, then re-run `install_alwrity.bat`.
+  - The installer will set up everything automatically. This may take a few minutes.
+
+### 3. Start ALwrity
+- After installation, open a new Command Prompt window.
+- Type:
+  ```
+  alwrity
+  ```
+- Press Enter. ALwrity will start!
+
+---
+
+## Troubleshooting
+- **Not running as administrator:**
+  - Right-click `install_alwrity.bat` and select "Run as administrator".
+- **Python not found:**
+  - Make sure you installed Python 3.11 and checked "Add Python 3.11 to PATH".
+  - Restart your computer after installing Python.
+- **Permission errors:**
+  - Make sure you are running as administrator.
+- **Other errors:**
+  - Take a screenshot of the error and [open an issue on GitHub](https://github.com/AJaySi/AI-Writer/issues).
+
+---
+
+## FAQ
+- **Do I need to install anything else?**
+  - No, `install_alwrity.bat` will handle everything for you.
+- **Can I run this on Mac or Linux?**
+  - No, this installer is for Windows only. See the Docker or manual instructions for other systems.
+- **Is it safe?**
+  - Yes, the script only installs ALwrity and its dependencies.
+
+---
+
+## Need More Help?
+- [Open an issue on GitHub](https://github.com/AJaySi/AI-Writer/issues)
+- Join our support community
+
+---
--- a/Started/Option_1_Windows_Quick_Install/install_alwrity_windows.bat
+++ b/Started/Option_1_Windows_Quick_Install/install_alwrity_windows.bat
@@ -0,0 +1,122 @@
+@echo off
+setlocal enabledelayedexpansion
+
+s :: Set colors for better visibility
+color 0A
+
+:: Set the Python version requirement
+set MIN_PYTHON_VERSION=3.9
+
+echo ===============================================
+echo           ALwrity Installation Setup
+echo ===============================================
+echo.
+
+echo [1/5] Checking Python installation...
+python --version > nul 2>&1
+if errorlevel 1 (
+    color 0C
+    echo [ERROR] Python is not installed!
+    echo Please install Python %MIN_PYTHON_VERSION% or higher from python.org
+    echo Press any key to exit...
+    pause > nul
+    exit /b 1
+)
+
+:: Get Python version
+for /f "tokens=2" %%V in ('python --version 2^>^&1') do set PYTHON_VERSION=%%V
+for /f "tokens=1,2 delims=." %%a in ("%PYTHON_VERSION%") do (
+    set PYTHON_MAJOR=%%a
+    set PYTHON_MINOR=%%b
+)
+
+:: Check Python version
+set /a PYTHON_VER=%PYTHON_MAJOR%*100 + %PYTHON_MINOR%
+set /a MIN_VER=309
+if %PYTHON_VER% LSS %MIN_VER% (
+    color 0C
+    echo [ERROR] Python version %MIN_PYTHON_VERSION% or higher is required!
+    echo Current version: %PYTHON_VERSION%
+    echo Please upgrade Python from python.org
+    echo Press any key to exit...
+    pause > nul
+    exit /b 1
+)
+
+echo [✓] Python %PYTHON_VERSION% detected
+echo.
+
+echo [2/5] Creating virtual environment...
+python -m venv "%~dp0..\..\venv"
+if errorlevel 1 (
+    color 0C
+    echo [ERROR] Failed to create virtual environment!
+    echo Press any key to exit...
+    pause > nul
+    exit /b 1
+)
+echo [✓] Virtual environment created
+echo.
+
+echo [3/5] Activating virtual environment...
+call "%~dp0..\..\venv\Scripts\activate.bat"
+if errorlevel 1 (
+    color 0C
+    echo [ERROR] Failed to activate virtual environment!
+    echo Press any key to exit...
+    pause > nul
+    exit /b 1
+)
+echo [✓] Virtual environment activated
+echo.
+
+echo [4/5] Upgrading pip...
+python -m pip install --upgrade pip
+if errorlevel 1 (
+    color 0C
+    echo [ERROR] Failed to upgrade pip!
+    echo Press any key to exit...
+    pause > nul
+    exit /b 1
+)
+echo [✓] Pip upgraded
+echo.
+
+echo [5/5] Installing requirements...
+pip install -r "%~dp0..\..\requirements.txt"
+if errorlevel 1 (
+    color 0C
+    echo [ERROR] Failed to install requirements!
+    echo Press any key to exit...
+    pause > nul
+    exit /b 1
+)
+echo [✓] Requirements installed
+echo.
+
+color 0A
+echo ===============================================
+echo       Installation Completed Successfully!
+echo ===============================================
+echo.
+echo Next steps to run ALwrity:
+echo.
+echo 1. Open a new Command Prompt window
+echo 2. Navigate to the ALwrity root directory by copying and pasting this command:
+echo    cd /d "%~dp0..\.."
+echo.
+echo 3. Activate the virtual environment by copying and pasting this command:
+echo    "%~dp0..\..\venv\Scripts\activate.bat"
+echo.
+echo 4. Run ALwrity with Streamlit by copying and pasting this command:
+echo    streamlit run "%~dp0..\..\alwrity.py"
+echo.
+echo Note: You'll need to activate the virtual environment (step 3)
+echo       each time you want to run ALwrity.
+echo.
+echo Troubleshooting:
+echo - If you see any errors, make sure Python is in your PATH
+echo - For help, visit: https://github.com/yourusername/ALwrity
+echo.
+echo Press any key to exit...
+pause > nul