---
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!** 🚀