PySpur - Visuelle Entwicklungsplattform für KI-Agenten
Projektübersicht
PySpur ist eine visuelle Workflow-Plattform für KI-Agenten, die es KI-Ingenieuren ermöglicht, KI-Agenten 10-mal schneller iterativ zu entwickeln. Es handelt sich um ein von Y Combinator unterstütztes Open-Source-Projekt, das speziell entwickelt wurde, um die wichtigsten Herausforderungen zu lösen, mit denen KI-Ingenieure beim Aufbau von Agenten konfrontiert sind.
Gelöste Kernprobleme
KI-Ingenieure stehen beim Aufbau von Agenten vor drei großen Herausforderungen:
- Prompt-Hölle: Viel Zeit für Prompt-Optimierung und wiederholtes Ausprobieren
- Workflow-Blindstellen: Mangelnde Visualisierung der Schrittinteraktionen, was zu versteckten Fehlern und Verwirrung führt
- Terminal-Test-Albtraum: Notwendigkeit, auf die Rohausgabe zu starren und JSON manuell zu parsen
Kernfunktionsmerkmale
🔄 Workflow-Management
- Visuelle grafische Oberfläche: Erstellung von KI-Workflows per Drag & Drop
- Schleifenunterstützung: Unterstützung für iterative Tool-Aufrufe mit Speicher
- Mensch-Maschine-Zusammenarbeit: Persistente Workflows, die auf manuelle Genehmigung warten können
- Breakpoint-Debugging: Workflow-Haltepunkte, die eine manuelle Genehmigung erfordern, bevor die Ausführung fortgesetzt wird
📤 Multimodale Datenverarbeitung
- Datei-Upload: Unterstützung für das Hochladen von Dateien oder das Einfügen von URLs zur Dokumentenverarbeitung
- Multimodale Unterstützung: Verarbeitung verschiedener Formate wie Video, Bild, Audio, Text, Code usw.
- Strukturierte Ausgabe: Bereitstellung eines UI-Editors für JSON-Schemas
🗃️ RAG-System
- Vollständiger RAG-Prozess: Parsen, Chunking, Einbetten und Einfügen von Daten in eine Vektordatenbank
- Vektordatenbank-Integration: Unterstützung verschiedener Vektordatenbanken
🧰 Tool-Integration
- Umfangreiche Tool-Unterstützung: Integration von Slack, Firecrawl.dev, Google Sheets, GitHub usw.
- Erweiterbarkeit: Hinzufügen neuer Knoten durch Erstellung einer einzelnen Python-Datei
📊 Überwachung und Bewertung
- Automatische Verfolgung: Automatisches Erfassen der Ausführungsspuren bereitgestellter Agenten
- Bewertungssystem: Bewertung der Agentenleistung auf realen Datensätzen
- One-Click-Deployment: Veröffentlichung als API und Integration überall
🎛️ Multi-Vendor-Unterstützung
- Unterstützung von über 100 Anbietern: Unterstützung von über 100 LLM-Anbietern, Embeddern und Vektordatenbanken
- Python-basiert: Basierend auf Python aufgebaut, einfach zu erweitern und anzupassen
Schnellstart
Installationsvoraussetzungen
- Python 3.11 oder höher
Grundlegende Installationsschritte
- PySpur installieren
pip install pyspur
- Neues Projekt initialisieren
pyspur init my-project
cd my-project
- Server starten
pyspur serve --sqlite
Standardmäßig startet dies die PySpur-Anwendung unter http://localhost:6080 mit einer SQLite-Datenbank. Es wird empfohlen, eine PostgreSQL-Instanz-URL in der .env-Datei zu konfigurieren, um eine stabilere Erfahrung zu erzielen.
- Umgebung und API-Schlüssel konfigurieren (optional)
- Anwendungsoberfläche: Navigieren Sie zur Registerkarte API-Schlüssel, um Anbieterschlüssel hinzuzufügen (OpenAI, Anthropic usw.)
- Manuelle Methode: Bearbeiten Sie die
.env-Datei (empfohlene Konfiguration für PostgreSQL) und starten Siepyspur serveneu
Entwicklungsumgebung einrichten
Empfohlene Methode: Verwendung eines Entwicklungscontainers
Es wird empfohlen, Cursor/VS Code in Verbindung mit einem Entwicklungscontainer (.devcontainer/devcontainer.json) zu verwenden, um Folgendes zu erhalten:
- Eine konsistente Entwicklungsumgebung mit vorkonfigurierten Tools und Erweiterungen
- Optimierte Einstellungen für die Python- und TypeScript-Entwicklung
- Automatisches Hot-Reloading und Portweiterleitung
Schritte:
- Installieren Sie Cursor/VS Code und die Dev Containers-Erweiterung
- Klonen und öffnen Sie das Repository
- Klicken Sie bei Aufforderung auf "In Container erneut öffnen"
Manuelle Einrichtung
- Repository klonen
git clone https://github.com/PySpur-com/pyspur.git
cd pyspur
- Mit docker-compose starten
docker compose -f docker-compose.dev.yml up --build -d
- Benutzerdefinierte Einstellungen: Bearbeiten Sie die
.env-Datei, um die Umgebung zu konfigurieren (z. B. PostgreSQL-Einstellungen)
Hinweis: Die manuelle Einrichtung erfordert zusätzliche Konfigurationen und enthält möglicherweise nicht alle Funktionen des Entwicklungscontainers.
Anwendungsfälle
PySpur eignet sich besonders für folgende Szenarien:
- Komplexe KI-Workflows, die ein visuelles Debugging erfordern
- Qualitätssicherungsprozesse, die eine menschliche Überwachung erfordern
- Multimodale Datenverarbeitungsanwendungen
- RAG-Systemaufbau und -optimierung
- Bereitstellung von KI-Agenten in großem Maßstab
Technische Architektur
- Frontend: Workflow-Editor basierend auf einer grafischen Oberfläche
- Backend: Python-basierte Ausführungs-Engine
- Datenbank: Unterstützung für SQLite und PostgreSQL
- Deployment: Unterstützung für Container-basiertes Deployment und One-Click-API-Veröffentlichung