https://github.com/iteranya/asta-ai-editor
A simple markdown viewer with AI slapped on top of it.
https://github.com/iteranya/asta-ai-editor
Last synced: 20 days ago
JSON representation
A simple markdown viewer with AI slapped on top of it.
- Host: GitHub
- URL: https://github.com/iteranya/asta-ai-editor
- Owner: Iteranya
- Created: 2025-04-26T12:33:49.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-29T11:42:09.000Z (about 1 month ago)
- Last Synced: 2025-05-12T12:18:31.840Z (20 days ago)
- Language: JavaScript
- Size: 270 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Asta AI Markdown Editor
Welcome to Asta AI Markdown Editor, where coding meets cuteness! ✨ This isn't just another boring Markdown editor—it's your new best friend for organizing projects, writing docs, and sprinkling a little AI magic into your workflow. Built with love on **FastAPI**, **SQLite**, and pure **Vanilla JS/CSS/HTML**, Asta is here to make your life easier—and way more fun.
---
## 🎉 Core Features That Make Asta Special
### ✏️ Markdown Mastery
**Split View Magic**
Write your raw Markdown on the left, and watch it come to life on the right! It's like having a tiny wizard in your browser, casting spells to turn your words into beautiful docs. The real-time preview ensures what you see is exactly what you'll get.
### 🤖 AI Integration
**AI Brainstorm Buddy**
Stuck? Let the AI take over! The bottom AI pane will continue your thoughts without messing up your work. It's like having a coding buddy who's always ready to help—but without the coffee breath. Just type in the text box below the editor and write down what you want the AI to write.
**Rewrite Wizardry**
Highlight some text, right-click, and boom! The AI will polish your words like a pro. Perfect for when you want to sound smart without actually trying. Just right click and type down what you want AI to do with that passage.
**Notes for Nerds**
Got extra context or random thoughts? Throw them into the Notes panel, and the AI will use them to make your writing even better. It's like giving your AI a cheat sheet!
### 📄 LaTeX Superpowers
**LaTeX Export System**
Transform your Markdown masterpiece into professional LaTeX documents with a single click! The exporter automatically generates a complete LaTeX project with all necessary configurations, properly formatted sections, and bibliography management.
**Image Integration**
No more manual image handling headaches! All images pasted or referenced in your Markdown automatically get packaged in your LaTeX export. The system intelligently handles image paths and figure environments.
**Overleaf Compatibility**
Get a neatly packaged zip file that's ready to upload directly to Overleaf. Collaborate with colleagues or submit your paper without fighting with configuration files or missing dependencies.
**Experimental LaTeX Viewer**
Preview your LaTeX output directly in Asta using our integrated Tectonic-powered renderer. While still in beta (expect some bugs!), it offers an immediate preview of how your document will look as a properly typeset PDF. Perfect for catching formatting issues before export.
### 🗂️ Project Management
**Workspace Wonderland**
Create new projects with a single click. No project? No problem! You can still work, but saving is disabled—so don't forget to create one before you get too deep into your genius ideas. Each project maintains its own directory structure, images, and settings.
**Intelligent File Management**
Asta automatically organizes your files, handling relationships between markdown document, images, and converted latex document.
### 🖼️ Media Handling
**Image Paste Party**
Copy-paste images directly into the editor, and they'll be saved in your project directory. It's like magic, but with fewer rabbits and more Markdown. Support for screenshots, web images, and local files means no more awkward image management workflows.
## 🛠️ How to Get Started
1. **Clone the Repo**
```bash
git clone https://github.com/Iteranya/Asta-AI-Editor.git
cd Asta-AI-Editor
```
2. **Install Dependencies**
```bash
pip install -r requirements.txt
```
3. **Configure AI (Optional)**
Check out the example.config.json to configure your key, model, and system prompt
```
{
"system_note": "ONLY WRITE IN MARKDOWN FORMAT.",
"ai_endpoint": "https://llm.chutes.ai/v1",
"base_llm": "deepseek-ai/DeepSeek-V3-0324",
"temperature": 0.5,
"ai_key": "your-secret-key"
}
```
4. **Run the Server**
```bash
uvicorn main:app --reload --port 5452
```
5. **Open Your Browser**
Head to `http://localhost:5452` and let the fun begin!
---
## 🧙♂️ Tech Stack
- **Backend**: FastAPI for lightning-fast API responses, SQLite for reliable data storage, OpenAI API for intelligent text generation
- **Frontend**: Pure Vanilla JavaScript, HTML, and CSS—no bloated frameworks, just clean, efficient code
- **LaTeX Engine**: Tectonic for local rendering (experimental), custom export system for Overleaf compatibility
- **Image Processing**: Pillow for automatic image optimization and formatting
---
## 📄 License
GPL-3 License. Use it, tweak it, build on it—just don't gatekeep it! We believe in open source and the power of community improvements.
---
## 🚀 Pro Tips
- Use keyboard shortcut `Ctrl+Space` to trigger AI suggestions anywhere in your document
- The LaTeX exporter supports custom preambles—add special packages in the project settings
- For mathematical content, Asta renders LaTeX math in the preview pane—just use `$` for inline and `$$` for display math
- Enable "Focus Mode" (F11) for distraction-free writing with just your content and the preview
- Try the "Dark Scholar" theme for late-night writing sessions that won't strain your eyes
---
## 🔮 Coming Soon
- Citation management with BibTeX integration
- Collaborative editing for team projects
- Custom themes and style options
- Extended template library for academic papers, reports, and more