mindnet/docs/00_General/00_quickstart.md

doc_type	audience	status	version	context
quickstart_guide	user, developer, admin	active	2.9.1	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

git clone <repository-url> mindnet
cd mindnet

Schritt 2: Virtuelle Umgebung erstellen

python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

Schritt 3: Abhängigkeiten installieren

pip install -r requirements.txt

Schritt 4: Qdrant starten (Docker)

docker compose up -d qdrant

Schritt 5: Ollama-Modelle laden

ollama pull phi3:mini
ollama pull nomic-embed-text

Schritt 6: Konfiguration anpassen

Erstelle eine .env-Datei im Projektroot:

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

uvicorn app.main:app --reload --port 8001

Schritt 2: Frontend starten (neues Terminal)

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:

---
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:

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 - Lerne die Chat-Funktionen kennen
2. Knowledge Design - Verstehe, wie du Notizen strukturierst
3. Authoring Guidelines - 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.

🔗 Weitere Ressourcen

• Dokumentationskarte - Übersicht aller Dokumente
• Glossar - Wichtige Begriffe erklärt
• Vision & Strategie - Die Philosophie hinter Mindnet

---

Viel Erfolg mit Mindnet! 🚀