melchat 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 Melvin Carvalho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# melchat
+
+> **100+ AI models. One command. Zero backend.**
+
+```bash
+npx melchat
+```
+
+That's it. Open your browser and start chatting with GPT-4, Claude, Gemini, Llama, Qwen, DeepSeek, and 100+ more models.
+
+---
+
+## Why melchat?
+
+| Feature | melchat | Others |
+|---------|---------|--------|
+| Models supported | **100+** | 1-5 |
+| File size | **69KB** | 10MB+ |
+| Backend required | **No** | Usually |
+| Install time | **3 seconds** | Minutes |
+| Free models | **Yes** | Rarely |
+
+## Quick Start
+
+```bash
+# Run instantly (no install needed)
+npx melchat
+
+# Or install globally
+npm install -g melchat
+melchat
+```
+
+## Supported Models
+
+### Free Tier (No API key needed via OpenRouter)
+- Gemma 2 9B
+- Llama 3.1 8B
+- Phi-3 Medium
+- Qwen 2 7B
+- MiMo V2
+
+### Frontier Models
+- **OpenAI**: GPT-4o, GPT-4 Turbo, GPT-3.5
+- **Anthropic**: Claude 3.5 Sonnet, Claude 3 Opus
+- **Google**: Gemini Pro, Gemini Flash
+- **Meta**: Llama 3.3 70B, Llama 3.1 405B
+- **DeepSeek**: V3, R1
+- **Qwen**: 2.5 72B, QwQ 32B
+
+### Image & Video Generation
+- Flux.1 (text-to-image)
+- Kling 2.6 Pro (text-to-video)
+- Z-Image Turbo (fal.ai)
+
+### Local Models
+- Ollama endpoints
+- RunPod
+- vLLM
+- Any OpenAI-compatible API
+
+## Features
+
+- **Streaming responses** - Real-time token streaming
+- **Conversation history** - Saved locally in browser
+- **Token counter** - Track usage and costs
+- **Code highlighting** - Syntax highlighting for 100+ languages
+- **Mobile responsive** - Works on any device
+- **Export chats** - Markdown, JSON, or plain text
+- **System prompts** - Customize AI behavior
+- **Multi-language UI** - EN, DE, FR, CS, UK, RU
+
+## CLI Options
+
+```bash
+melchat [options]
+
+Options:
+  -p, --port <port>   Port to run on (default: 3000)
+  --no-open           Don't auto-open browser
+  -h, --help          Show help
+```
+
+## Configuration
+
+1. Get a free API key from [OpenRouter](https://openrouter.ai/)
+2. Run `npx melchat`
+3. Click the gear icon and paste your key
+4. Start chatting!
+
+For local models, enter your endpoint URL (e.g., `http://localhost:11434/v1` for Ollama).
+
+## Deploy Anywhere
+
+melchat is a single HTML file. Deploy it anywhere:
+
+```bash
+# GitHub Pages (already configured)
+# Netlify (drag & drop)
+# Vercel (one click)
+# Any static host
+```
+
+Or just open `dist/index.html` directly in your browser.
+
+## Tech Stack
+
+- Vanilla JavaScript (no framework)
+- Zero runtime dependencies
+- marked.js for Markdown
+- highlight.js for code
+
+## Contributing
+
+PRs welcome! This is a single-file app at `dist/index.html`.
+
+```bash
+git clone https://github.com/melvincarvalho/melchat
+cd melchat
+npx melchat
+```
+
+## License
+
+MIT
+
+---
+
+**Star this repo** if you find it useful!
+
+[GitHub](https://github.com/melvincarvalho/melchat) | [Issues](https://github.com/melvincarvalho/melchat/issues) | [OpenRouter](https://openrouter.ai/)

package/bin/melchat.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const { exec } = require('child_process');
+
+// Parse CLI arguments
+const args = process.argv.slice(2);
+const flags = {
+  port: 3000,
+  open: true,
+  help: false
+};
+
+for (let i = 0; i < args.length; i++) {
+  const arg = args[i];
+  if (arg === '-p' || arg === '--port') {
+    flags.port = parseInt(args[++i], 10) || 3000;
+  } else if (arg === '--no-open') {
+    flags.open = false;
+  } else if (arg === '-h' || arg === '--help') {
+    flags.help = true;
+  }
+}
+
+if (flags.help) {
+  console.log(`
+  melchat - 100+ AI models in one chat interface
+
+  Usage:
+    melchat [options]
+    npx melchat [options]
+
+  Options:
+    -p, --port <port>   Port to run server on (default: 3000)
+    --no-open           Don't auto-open browser
+    -h, --help          Show this help message
+
+  Examples:
+    melchat                    Start on port 3000 and open browser
+    melchat -p 8080            Start on port 8080
+    melchat --no-open          Start without opening browser
+
+  More info: https://github.com/melvincarvalho/melchat
+`);
+  process.exit(0);
+}
+
+// Find the dist/index.html file
+const distPath = path.join(__dirname, '..', 'dist', 'index.html');
+
+if (!fs.existsSync(distPath)) {
+  console.error('Error: dist/index.html not found');
+  console.error('Expected at:', distPath);
+  process.exit(1);
+}
+
+const htmlContent = fs.readFileSync(distPath, 'utf8');
+
+// Create server
+const server = http.createServer((req, res) => {
+  // Serve index.html for all routes (SPA)
+  res.writeHead(200, {
+    'Content-Type': 'text/html; charset=utf-8',
+    'Cache-Control': 'no-cache'
+  });
+  res.end(htmlContent);
+});
+
+// Start server
+server.listen(flags.port, () => {
+  const url = `http://localhost:${flags.port}`;
+
+  console.log(`
+  ╔═══════════════════════════════════════════════════╗
+  ║                                                   ║
+  ║   🤖 melchat v0.0.1                               ║
+  ║   100+ AI models in one interface                 ║
+  ║                                                   ║
+  ║   Running at: ${url.padEnd(31)}║
+  ║                                                   ║
+  ║   Press Ctrl+C to stop                            ║
+  ║                                                   ║
+  ╚═══════════════════════════════════════════════════╝
+`);
+
+  // Auto-open browser
+  if (flags.open) {
+    const platform = process.platform;
+    let cmd;
+
+    if (platform === 'darwin') {
+      cmd = `open ${url}`;
+    } else if (platform === 'win32') {
+      cmd = `start ${url}`;
+    } else {
+      cmd = `xdg-open ${url}`;
+    }
+
+    exec(cmd, (err) => {
+      if (err) {
+        console.log(`  Open ${url} in your browser\n`);
+      }
+    });
+  }
+});
+
+// Handle graceful shutdown
+process.on('SIGINT', () => {
+  console.log('\n  Shutting down melchat...\n');
+  server.close();
+  process.exit(0);
+});