|
1 | | -# Astro Starter Kit: Minimal |
| 1 | +# NEO — Self-Hosted AI auf Custom Hardware |
2 | 2 |
|
3 | | -```sh |
4 | | -npm create astro@latest -- --template minimal |
5 | | -``` |
| 3 | +<p align="center"> |
| 4 | + <img src="public/img/og-image.png" alt="NEO — Self-Hosted AI" width="600" /> |
| 5 | +</p> |
6 | 6 |
|
7 | | -> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun! |
| 7 | +> Ein KI-Agent. Ein MiniPC. Null Cloud. Gebaut von Merlin Lietz. |
8 | 8 |
|
9 | | -## 🚀 Project Structure |
| 9 | +**[🌐 Live ansehen → neo.lietztech.com](https://neo.lietztech.com)** |
10 | 10 |
|
11 | | -Inside of your Astro project, you'll see the following folders and files: |
| 11 | +--- |
12 | 12 |
|
13 | | -```text |
14 | | -/ |
15 | | -├── public/ |
16 | | -├── src/ |
17 | | -│ └── pages/ |
18 | | -│ └── index.astro |
19 | | -└── package.json |
20 | | -``` |
| 13 | +## Was ist NEO? |
| 14 | + |
| 15 | +NEO ist mein persönliches Homelab-Projekt: ein vollständig self-hosted KI-System auf einem €200-MiniPC. |
| 16 | +Kein Cloud-Abo, kein Vendor Lock-in — alles läuft auf eigener Hardware. |
21 | 17 |
|
22 | | -Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name. |
| 18 | +Diese Website dokumentiert das Projekt als interaktives Showcase mit Live-Dashboard, Terminal-Demo und System-Statistiken in Echtzeit. |
23 | 19 |
|
24 | | -There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components. |
| 20 | +## Tech Stack |
25 | 21 |
|
26 | | -Any static assets, like images, can be placed in the `public/` directory. |
| 22 | +| Kategorie | Technologie | |
| 23 | +|-----------|------------| |
| 24 | +| **Frontend** | Astro v6, Tailwind CSS v4, Three.js, GSAP | |
| 25 | +| **Hardware** | ACE Magic S (Intel N97, 16GB RAM) | |
| 26 | +| **Virtualisierung** | Proxmox VE 9 | |
| 27 | +| **Container** | Docker (8+ Services) | |
| 28 | +| **Reverse Proxy** | Caddy + Cloudflare Tunnel | |
| 29 | +| **KI** | LiteLLM, Ollama (11 Modelle) | |
| 30 | +| **Automatisierung** | n8n, Cron, OpenClaw Agent | |
| 31 | +| **DMS** | Paperless-ngx | |
| 32 | +| **Benachrichtigungen** | Gotify, Telegram Bot | |
27 | 33 |
|
28 | | -## 🧞 Commands |
| 34 | +## Features |
29 | 35 |
|
30 | | -All commands are run from the root of the project, from a terminal: |
| 36 | +- 🎨 **Cinematic 3D Background** — PBR-Orbs mit Fresnel-Shader (Three.js) |
| 37 | +- 📊 **Live Dashboard** — CPU, RAM, Disk, Docker-Stats in Echtzeit |
| 38 | +- 💻 **Terminal Demo** — Interaktiver Chat + 8 Bot-Szenarien |
| 39 | +- 📱 **Telegram Preview** — Echte Bot-Konversation als Mockup |
| 40 | +- 🤖 **AI Model Roster** — Alle 11 KI-Modelle mit Benchmarks |
| 41 | +- ⚡ **Automation Timeline** — 14 Automatisierungen visualisiert |
| 42 | +- 💰 **Cost Ticker** — Self-Hosted vs. Cloud Kostenvergleich |
| 43 | +- 🎯 **Performance** — Three.js Code-Split, Mobile-Disable, IntersectionObserver |
31 | 44 |
|
32 | | -| Command | Action | |
33 | | -| :------------------------ | :----------------------------------------------- | |
34 | | -| `npm install` | Installs dependencies | |
35 | | -| `npm run dev` | Starts local dev server at `localhost:4321` | |
36 | | -| `npm run build` | Build your production site to `./dist/` | |
37 | | -| `npm run preview` | Preview your build locally, before deploying | |
38 | | -| `npm run astro ...` | Run CLI commands like `astro add`, `astro check` | |
39 | | -| `npm run astro -- --help` | Get help using the Astro CLI | |
| 45 | +## Entwicklung |
| 46 | + |
| 47 | +```bash |
| 48 | +npm install # Dependencies |
| 49 | +npm run dev # Dev-Server (localhost:4321) |
| 50 | +npm run build # Produktions-Build |
| 51 | +``` |
| 52 | + |
| 53 | +## Deployment |
| 54 | + |
| 55 | +Build via rsync auf Nginx-Server (LXC 113). Cloudflare Tunnel routet neo.lietztech.com. |
| 56 | + |
| 57 | +```bash |
| 58 | +npm run build |
| 59 | +rsync -avz dist/ root@192.168.8.113:/var/www/neo-website/ |
| 60 | +``` |
40 | 61 |
|
41 | | -## 👀 Want to learn more? |
| 62 | +## Lizenz |
42 | 63 |
|
43 | | -Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat). |
| 64 | +MIT © Merlin Lietz |
0 commit comments