Lars
5225090490
All checks were successful
Deploy mindnet to llm-node / deploy (push) Successful in 3s
157 lines
3.4 KiB
Markdown
157 lines
3.4 KiB
Markdown
---
|
|
doc_type: quickstart_guide
|
|
audience: user, developer, admin
|
|
status: active
|
|
version: 2.9.1
|
|
context: "Schnellstart-Anleitung für neue Benutzer von Mindnet"
|
|
---
|
|
|
|
# Mindnet Schnellstart
|
|
|
|
Diese Anleitung hilft dir, in 15 Minuten mit Mindnet loszulegen.
|
|
|
|
## 🎯 Was ist Mindnet?
|
|
|
|
Mindnet ist ein **persönliches KI-Gedächtnis**, das:
|
|
- Dein Wissen in Markdown-Notizen speichert
|
|
- Semantisch verknüpft (Wissensgraph)
|
|
- Als intelligenter Dialogpartner agiert (RAG-Chat)
|
|
- **Lokal und privat** läuft (Privacy First)
|
|
|
|
## 📋 Voraussetzungen
|
|
|
|
- **Python 3.10+** installiert
|
|
- **Docker** installiert (für Qdrant)
|
|
- **Ollama** installiert (für lokale LLMs)
|
|
- Optional: **Obsidian** (für komfortables Schreiben)
|
|
|
|
## ⚡ Installation (5 Minuten)
|
|
|
|
### Schritt 1: Repository klonen
|
|
|
|
```bash
|
|
git clone <repository-url> mindnet
|
|
cd mindnet
|
|
```
|
|
|
|
### Schritt 2: Virtuelle Umgebung erstellen
|
|
|
|
```bash
|
|
python3 -m venv .venv
|
|
source .venv/bin/activate # Windows: .venv\Scripts\activate
|
|
```
|
|
|
|
### Schritt 3: Abhängigkeiten installieren
|
|
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
### Schritt 4: Qdrant starten (Docker)
|
|
|
|
```bash
|
|
docker compose up -d qdrant
|
|
```
|
|
|
|
### Schritt 5: Ollama-Modelle laden
|
|
|
|
```bash
|
|
ollama pull phi3:mini
|
|
ollama pull nomic-embed-text
|
|
```
|
|
|
|
### Schritt 6: Konfiguration anpassen
|
|
|
|
Erstelle eine `.env`-Datei im Projektroot:
|
|
|
|
```ini
|
|
QDRANT_URL=http://localhost:6333
|
|
MINDNET_OLLAMA_URL=http://localhost:11434
|
|
MINDNET_LLM_MODEL=phi3:mini
|
|
MINDNET_EMBEDDING_MODEL=nomic-embed-text
|
|
COLLECTION_PREFIX=mindnet
|
|
MINDNET_VAULT_ROOT=./vault
|
|
```
|
|
|
|
## 🚀 Erste Schritte (5 Minuten)
|
|
|
|
### Schritt 1: Backend starten
|
|
|
|
```bash
|
|
uvicorn app.main:app --reload --port 8001
|
|
```
|
|
|
|
### Schritt 2: Frontend starten (neues Terminal)
|
|
|
|
```bash
|
|
streamlit run app/frontend/ui.py --server.port 8501
|
|
```
|
|
|
|
### Schritt 3: Browser öffnen
|
|
|
|
Öffne `http://localhost:8501` im Browser.
|
|
|
|
### Schritt 4: Erste Notiz importieren
|
|
|
|
Erstelle eine Test-Notiz im `vault/` Ordner:
|
|
|
|
```markdown
|
|
---
|
|
id: 20250101-test
|
|
title: Meine erste Notiz
|
|
type: concept
|
|
status: active
|
|
---
|
|
|
|
# Meine erste Notiz
|
|
|
|
Dies ist eine Test-Notiz für Mindnet.
|
|
|
|
[[rel:related_to Mindnet]]
|
|
```
|
|
|
|
Dann importiere sie:
|
|
|
|
```bash
|
|
python3 -m scripts.import_markdown --vault ./vault --prefix mindnet --apply
|
|
```
|
|
|
|
### Schritt 5: Erste Chat-Anfrage
|
|
|
|
Im Browser-Chat eingeben:
|
|
```
|
|
Was ist Mindnet?
|
|
```
|
|
|
|
## 📚 Nächste Schritte
|
|
|
|
Nach dem Schnellstart empfehle ich:
|
|
|
|
1. **[Chat Usage Guide](../01_User_Manual/01_chat_usage_guide.md)** - Lerne die Chat-Funktionen kennen
|
|
2. **[Knowledge Design](../01_User_Manual/01_knowledge_design.md)** - Verstehe, wie du Notizen strukturierst
|
|
3. **[Authoring Guidelines](../01_User_Manual/01_authoring_guidelines.md)** - Lerne Best Practices für das Schreiben
|
|
|
|
## 🆘 Hilfe & Troubleshooting
|
|
|
|
**Problem:** Qdrant startet nicht
|
|
- **Lösung:** Prüfe, ob Docker läuft: `docker ps`
|
|
|
|
**Problem:** Ollama-Modell nicht gefunden
|
|
- **Lösung:** Prüfe mit `ollama list`, ob die Modelle geladen sind
|
|
|
|
**Problem:** Import schlägt fehl
|
|
- **Lösung:** Prüfe die Logs und stelle sicher, dass Qdrant läuft
|
|
|
|
Für detaillierte Troubleshooting-Informationen siehe [Admin Operations](../04_Operations/04_admin_operations.md#33-troubleshooting-guide).
|
|
|
|
## 🔗 Weitere Ressourcen
|
|
|
|
- **[Dokumentationskarte](00_documentation_map.md)** - Übersicht aller Dokumente
|
|
- **[Glossar](00_glossary.md)** - Wichtige Begriffe erklärt
|
|
- **[Vision & Strategie](00_vision_and_strategy.md)** - Die Philosophie hinter Mindnet
|
|
|
|
---
|
|
|
|
**Viel Erfolg mit Mindnet!** 🚀
|
|
|