|
4 | 4 | <img src="public/icon.png" alt="Milo Logo" width="128" height="128">
|
5 | 5 | </div>
|
6 | 6 |
|
7 |
| -Milo is a lightweight desktop application that helps you transform text using AI. It lives in your system tray and provides quick access to text transformation with customizable tones. |
| 7 | +Milo is a lightweight desktop application that helps you transform text using AI. Copy any text, hit a keyboard shortcut, and get instant AI transformations with customizable tones. |
8 | 8 |
|
9 |
| -## Features |
| 9 | +## ✨ Features |
10 | 10 |
|
11 |
| -- 🎯 Transform clipboard text with one click |
12 |
| -- 🎨 Customize transformation tones |
13 |
| -- 🔄 Quick access from system tray |
14 |
| -- ⚡ Fast and lightweight |
| 11 | +- 🎯 **Instant transformations** - Transform clipboard text with global shortcuts |
| 12 | +- 🎨 **Custom tones** - Create personalized transformation prompts |
| 13 | +- 📊 **Usage tracking** - Monitor your transformations and word counts |
| 14 | +- 🔄 **Auto-updates** - Seamless updates with built-in update system |
| 15 | +- 🌙 **Dark mode** - Beautiful light and dark themes |
| 16 | +- ⚡ **Lightweight** - Fast, native desktop app built with Tauri |
15 | 17 |
|
16 |
| -## Installation |
| 18 | +## 🚀 Quick Start |
17 | 19 |
|
18 |
| -### Prerequisites |
| 20 | +### Download |
19 | 21 |
|
20 |
| -- Node.js (v16 or later) |
21 |
| -- pnpm (latest version) |
22 |
| -- Rust (latest stable) |
23 |
| -- OpenAI API key |
| 22 | +1. Visit the [Releases page](https://github.com/antoncoding/milo/releases) |
| 23 | +2. Download the latest version for your platform |
| 24 | +3. Install and launch Milo |
24 | 25 |
|
25 |
| -### Build from Source |
| 26 | +### Setup |
26 | 27 |
|
27 |
| -1. Clone the repository: |
28 |
| -```bash |
29 |
| -git clone https://github.com/yourusername/milo.git |
30 |
| -cd milo |
31 |
| -``` |
| 28 | +1. **Get a usage key** from the [official Milo website](https://milo-ai.com) |
| 29 | +2. **Open Milo settings** from the system tray |
| 30 | +3. **Enter your usage key** in the settings |
| 31 | +4. **Start transforming!** Copy text and use the shortcut (default: `Cmd+M`) |
32 | 32 |
|
33 |
| -2. Install dependencies: |
34 |
| -```bash |
35 |
| -pnpm install |
36 |
| -``` |
| 33 | +## 🎯 How to Use |
37 | 34 |
|
38 |
| -3. Build the application: |
39 |
| -```bash |
40 |
| -pnpm run tauri build |
41 |
| -``` |
| 35 | +1. **Copy any text** you want to transform |
| 36 | +2. **Press your shortcut** (default: `Cmd+M`) |
| 37 | +3. **Your transformed text** replaces the clipboard content |
| 38 | +4. **Paste anywhere** - the improved text is ready to use! |
| 39 | + |
| 40 | +## ⚙️ Configuration |
42 | 41 |
|
43 |
| -The built application will be available in `src-tauri/target/release`. |
| 42 | +- **Custom shortcuts** - Set your preferred key combination |
| 43 | +- **Transform tones** - Create custom prompts for different writing styles |
| 44 | +- **Usage tracking** - View your transformation history and statistics |
| 45 | +- **Auto-updates** - Enable automatic app updates |
44 | 46 |
|
45 |
| -## Usage |
| 47 | +# Releasing |
46 | 48 |
|
47 |
| -1. Launch Milo - it will appear in your system tray |
48 |
| -2. Click the tray icon and select "Settings" |
49 |
| -3. Enter your OpenAI API key |
50 |
| -4. Copy any text you want to transform |
51 |
| -5. Click "Transform" from the tray menu |
52 |
| -6. The transformed text will be copied to your clipboard |
| 49 | +## 🔐 Important: Back Up Your Signing Key |
53 | 50 |
|
54 |
| -### Customizing Tones |
| 51 | +**For developers building from source:** |
55 | 52 |
|
56 |
| -1. Open Settings from the tray menu |
57 |
| -2. Click "Add New Tone" |
58 |
| -3. Enter a name and prompt for your custom tone |
59 |
| -4. Select your tone before transforming text |
| 53 | +Your Tauri signing key is located at `~/.tauri/milo.key`. **CRITICAL:** Back this up securely! |
60 | 54 |
|
61 |
| -## Development |
| 55 | +--- |
| 56 | + |
| 57 | +## 🛠️ Development |
| 58 | + |
| 59 | +### Prerequisites |
| 60 | + |
| 61 | +- Node.js (v16 or later) |
| 62 | +- pnpm (latest version) |
| 63 | +- Rust (latest stable) |
| 64 | +- Milo usage key (for testing) |
62 | 65 |
|
63 | 66 | ### Tech Stack
|
64 | 67 |
|
65 |
| -- Frontend: React + Vite |
66 |
| -- Backend: Rust + Tauri |
67 |
| -- AI: OpenAI API |
| 68 | +- **Frontend**: React + Vite + TypeScript + Tailwind CSS |
| 69 | +- **Backend**: Rust + Tauri v2 |
| 70 | +- **AI Integration**: LiteLLM proxy server |
| 71 | +- **Auto-updates**: Built-in Tauri updater with cryptographic signatures |
68 | 72 |
|
69 |
| -### Development Setup |
| 73 | +### Build from Source |
70 | 74 |
|
71 |
| -1. Install dependencies: |
72 |
| -```bash |
73 |
| -pnpm install |
74 |
| -``` |
| 75 | +1. **Clone and install**: |
| 76 | + ```bash |
| 77 | + git clone https://github.com/antoncoding/milo.git |
| 78 | + cd milo |
| 79 | + pnpm install |
| 80 | + ``` |
| 81 | + |
| 82 | +2. **Development server**: |
| 83 | + ```bash |
| 84 | + pnpm run tauri dev |
| 85 | + ``` |
| 86 | + |
| 87 | +3. **Production build**: |
| 88 | + ```bash |
| 89 | + pnpm run tauri build |
| 90 | + ``` |
| 91 | + |
| 92 | +### 🚀 Release Process |
75 | 93 |
|
76 |
| -2. Start development server: |
77 | 94 | ```bash
|
78 |
| -pnpm run tauri dev |
| 95 | +# Export signing key |
| 96 | +export TAURI_SIGNING_PRIVATE_KEY=$(cat ~/.tauri/milo.key) |
| 97 | + |
| 98 | +# Automated release |
| 99 | +pnpm release v0.1.9 |
79 | 100 | ```
|
80 | 101 |
|
81 |
| -### Building for Production |
82 | 102 |
|
83 |
| -```bash |
84 |
| -pnpm run tauri build |
| 103 | +### 📁 Project Structure |
| 104 | + |
| 105 | +``` |
| 106 | +milo/ |
| 107 | +├── src/ # React frontend |
| 108 | +├── src-tauri/ # Rust backend |
| 109 | +├── scripts/ # Release automation |
| 110 | +├── public/ # Static assets |
| 111 | +└── dist/ # Built frontend |
85 | 112 | ```
|
86 | 113 |
|
87 | 114 | ## Contributing
|
|
0 commit comments