hopefully fixed the markdown in readme

Author: Aaron J Clifft

README.md

@@ -1,96 +1,101 @@
-# **🚀 Astral-Drafter**
+# 🚀 Astral-Drafter
 
-\<div align="center"\>
+<div align="center">
 
 *A lean, local-first drafting tool for creative writers, powered by a custom GUI and a high-performance C++ inference engine.*
 
-Getting Started •
+[![GitHub license](https://img.shields.io/github/license/YOUR_GITHUB_USERNAME/Astral-Drafter)](https://github.com/YOUR_GITHUB_USERNAME/Astral-Drafter/blob/main/LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/YOUR_GITHUB_USERNAME/Astral-Drafter?style=social)](https://github.com/YOUR_GITHUB_USERNAME/Astral-Drafter/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/YOUR_GITHUB_USERNAME/Astral-Drafter?style=social)](https://github.com/YOUR_GITHUB_USERNAME/Astral-Drafter/network/members)
+[![GitHub issues](https://img.shields.io/github/issues/YOUR_GITHUB_USERNAME/Astral-Drafter)](https://github.com/YOUR_GITHUB_USERNAME/Astral-Drafter/issues)
 
-Tech Stack •
+[Getting Started](#-installation--setup) • 
+[Tech Stack](#-technology-stack--workflow) • 
+[Usage](#-usage) • 
+[Acknowledgements](#-acknowledgements)
 
-Usage •
+</div>
 
-Acknowledgements
-
-\</div\>
-
-## **📋 Overview**
+## 📋 Overview
 
 **Astral-Drafter** is a purpose-built, local-first application designed to accelerate the creative writing process. It combines a minimalist web-based GUI with a high-speed, locally-run LLM server, providing a powerful and private environment for drafting prose.
 
 This tool was created to overcome the limitations and overhead of generic AI tools, offering a streamlined workflow for writers who need maximum control and performance. The system is designed to handle very large contexts (64k+), allowing for entire scenes and character notes to be processed for superior narrative consistency.
 
-### **Key Features (v0.1)**
+### Key Features (v0.1)
 
-* **📝 Purpose-Built UI**: A clean, single-page web interface for pasting context, outlines, and character sheets.  
-* **🚀 High-Speed Generation**: Leverages llama.cpp for native performance and GPU acceleration.  
-* **💾 Auto-Save to File**: Generated prose is automatically saved to a user-specified file path.  
-* **🔒 100% Local & Private**: No data ever leaves your machine.  
-* **👆 One-Click Launch**: A simple batch script starts all necessary components.  
-* **💬 Conversational Editing**: After the initial draft, you can provide follow-up instructions to refine and rewrite the text.
+-   **📝 Purpose-Built UI**: A clean, single-page web interface for pasting context, outlines, and character sheets.
+-   **🚀 High-Speed Generation**: Leverages `llama.cpp` for native performance and GPU acceleration.
+-   **💾 Auto-Save to File**: Generated prose is automatically saved to a user-specified file path.
+-   **🔒 100% Local & Private**: No data ever leaves your machine.
+-   **👆 One-Click Launch**: A simple batch script starts all necessary components.
+-   **💬 Conversational Editing**: After the initial draft, you can provide follow-up instructions to refine and rewrite the text.
 
-## **✨ Screenshot (v0.1)**
+## ✨ Screenshot (v0.1)
 
-<img src="./assets/Astral_Drafter_GUI.png" alt="Screen shot of GUI" width="200">
+![Astral Drafter GUI](./assets/Astral_Draft_GUI.png)
 
-## **⚙️ Technology Stack & Workflow**
+## ⚙️ Technology Stack & Workflow
 
 This project is built on a lean, high-performance stack, ensuring maximum efficiency by avoiding heavy frameworks and communicating directly with a native inference engine.
 
-* **Inference Engine: llama.cpp Server**  
-  * Runs quantized GGUF models (e.g., Mistral-Nemo @ 64k context).  
-  * Provides near-native speed via C++ and GPU offloading (\--n-gpu-layers).  
-  * Exposes an OpenAI-compatible API endpoint for easy integration.  
-* **Backend Bridge: Custom Python Server (llama\_cpp\_server\_bridge.py)**  
-  * Built with Python 3's native http.server for zero external framework bloat.  
-  * Acts as middleware, receiving requests from the GUI and communicating with the llama.cpp server.  
-  * Handles all file system operations (creating directories, writing/overwriting scene files).  
-* **Frontend GUI: Single-File Web App (astral\_nexus\_drafter.html)**  
-  * Vanilla HTML, CSS, and JavaScript, ensuring no complex build steps are needed.  
-  * Styled with [Tailwind CSS](https://tailwindcss.com/) for a modern, responsive UI.  
-  * Communicates directly with the Python bridge server.  
-* **Launcher: Windows Batch Script (launch\_astral\_drafter.bat)**  
-  * Provides a "one-click" desktop experience.  
-  * Automates the startup of both the llama.cpp and Python bridge servers, then launches the GUI in the default browser.
+-   **Inference Engine: `llama.cpp` Server**
+    -   Runs quantized GGUF models (e.g., Mistral-Nemo @ 64k context).
+    -   Provides near-native speed via C++ and GPU offloading (`--n-gpu-layers`).
+    -   Exposes an OpenAI-compatible API endpoint for easy integration.
+
+-   **Backend Bridge: Custom Python Server (`llama_cpp_server_bridge.py`)**
+    -   Built with Python 3's native `http.server` for zero external framework bloat.
+    -   Acts as middleware, receiving requests from the GUI and communicating with the `llama.cpp` server.
+    -   Handles all file system operations (creating directories, writing/overwriting scene files).
 
-## **🚀 Installation & Setup**
+-   **Frontend GUI: Single-File Web App (`gui/astral_nexus_drafter.html`)**
+    -   Vanilla HTML, CSS, and JavaScript, ensuring no complex build steps are needed.
+    -   Styled with [Tailwind CSS](https://tailwindcss.com/) for a modern, responsive UI.
+    -   Communicates directly with the Python bridge server.
 
-### **Prerequisites**
+-   **Launcher: Windows Batch Script (`launch_astral_drafter.bat`)**
+    -   Provides a "one-click" desktop experience.
+    -   Automates the startup of both the `llama.cpp` and Python bridge servers, then launches the GUI in the default browser.
 
-* Windows Operating System  
-* Python 3.8+ installed  
-* Git for cloning the repository  
-* A pre-compiled version of llama.cpp's server.exe.  
-* A GGUF-formatted LLM file (e.g., Mistral-Nemo).
+## 🚀 Installation & Setup
 
-### **Installation**
+### Prerequisites
 
-1. **Clone your repository**
+-   Windows Operating System
+-   Python 3.8+ installed
+-   Git for cloning the repository
+-   A pre-compiled version of `llama.cpp`'s `server.exe`.
+-   A GGUF-formatted LLM file (e.g., Mistral-Nemo).
 
-\# Replace YOUR\_GITHUB\_USERNAME with your actual GitHub username  
-git clone \[https://github.com/YOUR\_GITHUB\_USERNAME/Astral-Drafter.git\](https://github.com/YOUR\_GITHUB\_USERNAME/Astral-Drafter.git)  
-cd Astral-Drafter
+### Installation
 
-2.   
-3. **Install Python Dependencies**
+1.  **Clone your repository**
+    ```bash
+    # Replace YOUR_GITHUB_USERNAME with your actual GitHub username
+    git clone https://github.com/YOUR_GITHUB_USERNAME/Astral-Drafter.git
+    cd Astral-Drafter
+    ```
 
-pip install \-r requirements.txt
+2.  **Install Python Dependencies**
+    ```bash
+    pip install -r requirements.txt
+    ```
 
-4.   
-5. **Configure the Launcher**  
-   * Open launch\_astral\_drafter.bat in a text editor.  
-   * Update the placeholder paths at the top of the file to point to your llama.cpp directory, your model file, and this project's directory.
+3.  **Configure the Launcher**
+    -   Open `launch_astral_drafter.bat` in a text editor.
+    -   Update the placeholder paths at the top of the file to point to your `llama.cpp` directory, your model file, and this project's directory.
 
-## **🖱️ Usage**
+## 🖱️ Usage
 
-1. Double-click the launch\_astral\_drafter.bat file (or a desktop shortcut pointing to it).  
-2. Two terminal windows will open for the servers, and the GUI will launch in your browser.  
-3. In the GUI, paste your context, outline, and character sheets into the text boxes on the left.  
-4. Specify an absolute file path for the output (e.g., D:\\Novels\\scene\_03.txt).  
-5. Click **"Start Scene"** to generate the first draft.  
-6. Once generated, use the chat input at the bottom to provide editing instructions. Each new generation will overwrite the file.  
-7. When finished, click the red **Shutdown** button in the GUI to close both server windows cleanly.
+1.  Double-click the `launch_astral_drafter.bat` file (or a desktop shortcut pointing to it).
+2.  Two terminal windows will open for the servers, and the GUI will launch in your browser.
+3.  In the GUI, paste your context, outline, and character sheets into the text boxes on the left.
+4.  Specify an absolute file path for the output (e.g., `D:\Novels\scene_03.txt`).
+5.  Click **"Start Scene"** to generate the first draft.
+6.  Once generated, use the chat input at the bottom to provide editing instructions. Each new generation will overwrite the file.
+7.  When finished, click the red **Shutdown** button in the GUI to close both server windows cleanly.
 
-## **🙏 Acknowledgements**
+## 🙏 Acknowledgements
 
-This project was built on the foundation of the excellent [mcp-ollama\_server](https://www.google.com/search?q=https://github.com/sethuram2003/mcp-ollama_server) by Sethuram. While this project has since been adapted to communicate directly with a llama.cpp server, the initial modular concept provided the inspiration.
+This project was built on the foundation of the excellent [mcp-ollama_server](https://github.com/sethuram2003/mcp-ollama_server) by Sethuram. While this project has since been adapted to communicate directly with a `llama.cpp` server, the initial modular concept provided the inspiration.