---
title: Ai Writer
emoji: 🚀
colorFrom: yellow
colorTo: yellow
sdk: gradio
sdk_version: 6.12.0
app_file: app.py
pinned: false
license: mit
---

# ✍️ AI Writer — Professional Text Generation Tool

AI Writer is a professional article generation tool that writes text indistinguishable from human-written content. It uses the GLM-5 API for generation and includes a built-in style analyzer, knowledge base system, and strict automated editor.

## Features

### 📚 Style Dataset Support
Upload up to 100 `.docx` files to build a writing style profile. The system analyzes your writing patterns — sentence length, contraction usage, paragraph structure, conjunction starts — and replicates your voice in generated text.

### 📖 Knowledge Base
Upload a `.docx` file with project-specific data. The system uses this information to write accurate articles with real facts, figures, and data from your knowledge base.

### 🔑 Keywords & LSI Keywords
Specify target keywords and LSI keywords with exact occurrence counts. Format: `word:count` per line (e.g., `bitcoin:3`). The system ensures each keyword appears the required number of times.

### 🌍 Country & Currency Support
Select a country and the system automatically:
- Uses the correct currency symbol (₹, $, €, £, etc.)
- Places the symbol before the amount
- Converts amounts according to exchange rates

### 📏 Word Count Control
Set minimum and maximum word counts. The editor verifies compliance and adjusts the text if needed.

### 🚫 Strict Content Rules
- **No dashes** (—, –, -) — automatically removed
- **No quotation marks** (" ", « », ' ') — automatically removed
- **No personal pronouns** (мы/наш/вы/ваш/ты/твой) — automatically removed
- **Russian language** for main text, configurable language for subheadings and keywords

### ✏️ Two-Pass Editor
1. **Automated editor** — removes forbidden characters, replaces currency codes, checks keyword counts
2. **LLM editor** — reviews content quality, heading consistency, and compliance with all requirements

### 🧠 Editable System Prompt
The core writing instructions are stored in `system_prompt.md` and can be edited directly through the UI or the file. This controls the AI's writing behavior, banned vocabulary, style rules, and process.

## How to Use

1. **⚙️ API Settings** — Verify your API connection (default token is pre-filled)
2. **📚 Datasets** — Upload your `.docx` writing samples to build a style profile
3. **📖 Knowledge Base** — Upload project-specific `.docx` data files
4. **📝 Generate Article** — Fill in the assignment and click Generate
5. **🧠 System Prompt** — Optionally edit the core writing instructions

## API Configuration

- **Default endpoint:** `https://api.us-west-2.modal.direct/v1/chat/completions`
- **Default model:** `zai-org/GLM-5.1-FP8`
- **Default token:** Pre-configured (changeable in API Settings tab)

To change the API token:
1. Go to **⚙️ API Settings** tab
2. Paste your new token
3. Click **🔍 Test Connection**

See [INSTALL.md](INSTALL.md) for detailed instructions on changing the API key and deployment.

## Deployment on Hugging Face Spaces

This application is designed to run on Hugging Face Spaces with the Gradio SDK.

1. Create a new Gradio Space
2. Upload all files from this folder
3. The Space will build and launch automatically

## File Structure

```
├── app.py                  # Main Gradio application
├── requirements.txt        # Python dependencies
├── system_prompt.md        # Editable system prompt (the "brain")
├── editor_prompt.md        # Editor prompt documentation
├── INSTALL.md              # Installation & API key guide
├── README.md               # This file
└── utils/
    ├── __init__.py
    ├── api_client.py        # GLM API client
    ├── docx_parser.py       # DOCX file parser
    ├── editor.py            # Automated editor & currency handler
    └── style_analyzer.py   # Dataset & knowledge base manager
```

## Supported Countries & Currencies

India (₹), Argentina ($), Bangladesh (৳), Spain (€), Germany (€), Poland (zł), France (€), USA ($), UK (£), China (¥), Japan (¥), South Korea (₩), Brazil (R$), Mexico ($), Canada ($), Australia ($), Italy (€), Netherlands (€), Belgium (€), Switzerland (CHF), Turkey (₺), Russia (₽), Ukraine (₴), Kazakhstan (₸), Belarus (Br), UAE (د.إ), Saudi Arabia (﷼), Egypt (E£), South Africa (R), Nigeria (₦), Kenya (KSh), Thailand (฿), Vietnam (₫), Indonesia (Rp), Philippines (₱), Malaysia (RM), Singapore ($), Israel (₪), Sweden (kr), Norway (kr), Denmark (kr), Finland (€), Portugal (€), Greece (€), Czech Republic (Kč), Romania (lei), Hungary (Ft), Austria (€), Ireland (€), and more.