artifact-site

English | 简体中文 | 日本語 | Deutsch | Français | Español

_{Diese Übersetzung wird zusammen mit der englischen Fassung gepflegt; bei Abweichungen gilt das Englische.}

Heute stehen unzählige KI-Agenten zur Auswahl, doch ihre Ergebnisse verteilen sich auf Ihren Computer, Chat-Verläufe und die Clouds verschiedener Plattformen. Das erschwert es, sie gemeinsam zu verwalten, zu teilen und später wiederzufinden.

artifact-site ist ein selbst gehosteter Arbeitsbereich für Einzelpersonen und Teams, ähnlich wie Claude Artifacts oder OpenAI Sites. Ihre verschiedenen Agenten erstellen die Inhalte; artifact-site verwaltet sie zentral: Seiten und Dokumente werden zu Links, mit Freigaben, Kommentaren und Feedback, Zugriffskontrolle und Versionsverlauf. Ihre bisherigen Agenten können die Arbeit über die CLI oder MCP weiter bearbeiten, veröffentlichen, durchsuchen und aktualisieren.

Sie können artifact-site selbst hosten oder die von Lexmount gehostete Cloud-Version nutzen.

Cloud-Version nutzen – von Lexmount gehostet, ohne eigene Bereitstellung. Ziehen Sie eine Datei hinein, um sie zu veröffentlichen und einen teilbaren Link zu erhalten. Laden Sie Dateien ohne Anmeldung hoch oder melden Sie sich mit Google oder GitHub an, um Ihre Sites zu behalten, in Ordnern zu organisieren und festzulegen, wer jeden Link öffnen darf.

Anonyme Uploads laufen nach einigen Tagen ab.

_{Datei ablegen, Link erhalten, teilen. Sehen Sie Ihre veröffentlichte Arbeit online an und legen Sie in den Freigabeeinstellungen fest, wer sie öffnen darf.}

Warum artifact-site

• Arbeit an einem Ort behalten. Ordnen Sie Seiten und Dokumente in Ordnern und finden Sie sie per Volltextsuche, auch auf Chinesisch. Teammitglieder und Agenten finden die Arbeit, auf die sie Zugriff haben.
• Ablegen und teilen. Laden Sie HTML, einen Build-Ordner, ein ZIP oder ein Dokument hoch und erhalten Sie einen Link. Große Websites werden in Teilen hochgeladen. Teilen Sie mit allen, mit angemeldeten Benutzern, mit bestimmten Personen oder mit Inhabern eines Zugangscodes.
• Veröffentlichte Arbeit weiter verbessern. Bearbeiten Sie HTML-Text oder -Quelltext im Browser, oder lassen Sie einen Agenten die ganze Website aktualisieren. Jede Änderung behält eine Version, mit Rollback und der Möglichkeit, eine Kopie zu speichern.
• Agenten dort weitermachen lassen, wo sie aufgehört haben. Veröffentlichen und aktualisieren Sie über den Leitfaden, die CLI oder MCP, suchen Sie dann nach Inhalt und lesen Sie extrahierbaren Text. Finden Sie zum Beispiel einen früheren Bericht und aktualisieren Sie ihn unter derselben Adresse, damit Ihr Team ihn ansehen kann.

Vergleich mit gehosteten Produkten

¹ Die Online-Vorschau von Office-Dokumenten benötigt Gotenberg. artifact-site hostet fertige Dateien und führt weder Anwendungs-Backends noch Build-Jobs aus.

Claude Artifacts und ChatGPT Sites verbinden die Erstellung mit gehosteter Freigabe. artifact-site ergänzt diese Abläufe um einen gemeinsamen Ort auf Ihrer eigenen Infrastruktur für Seiten und Dokumente aus verschiedenen Tools.

Funktionsumfang und Freigaben hängen vom Tarif ab und entwickeln sich weiter; siehe die offiziellen Leitfäden zu Claude Artifacts und ChatGPT Sites.

Inhalt

• Was Sie veröffentlichen können
• Schnellstart (lokale Installation)
• Einen Coding-Agenten anbinden
• Für Ihr Team bereitstellen
• So funktioniert es
• Dokumentation
• Mitwirken
• Lizenz

Was Sie veröffentlichen können

Bauen Sie Webprojekte vor dem Hochladen zu statischen Dateien; die Plattform führt keine Anwendungs-Backends oder Build-Jobs aus. PDF- und Office-Dokumente unterstützen keine visuelle HTML-Bearbeitung, und gescannte Bilder werden nicht automatisch per OCR erfasst.

Gehostete Seiten laufen in einer Sandbox und können die Anmeldesitzung der Plattform nicht verwenden. Verbindungen zu externen APIs erfordern eine Origin-Allowlist. Siehe Laufzeitgrenzen und Sicherheitsdesign.

Schnellstart (lokale Installation)

Sie können die Cloud-Version ohne Installation nutzen. Für eine lokale Installation führen Sie die folgenden drei Befehle aus. Sie benötigen Git, Make, Bash, Docker 24+ und das Compose-Plugin 2.24+. Unter macOS nutzen Sie Docker Desktop; unter Windows führen Sie die Befehle in WSL2 mit aktivierter WSL-Integration von Docker Desktop aus. Node, eine Domain oder ein Identitätsanbieter sind nicht erforderlich.

git clone https://github.com/lexmount/artifact-site.git && cd artifact-site
cp .env.example .env
make build up

Öffnen Sie nach dem Start http://127.0.0.1:4300 und legen Sie HTML, einen Ordner mit einer statischen Website oder ein PDF ab, um Ihre Arbeit anzusehen. Neue Websites sind standardmäßig privat; erstellen Sie in der Freigabe (Sharing) einen Link mit dem gewünschten Zugriff, bevor Sie ihn an jemanden weitergeben.

Der erste Lauf lädt Abhängigkeiten herunter und baut das Image, dann startet er die App und Postgres. Verwenden Sie diese Befehle in einem frischen Klon. Der Dienst ist standardmäßig nur lokal erreichbar; make down stoppt ihn und behält die Daten. Um ihn für Ihr Team erreichbar zu machen, folgen Sie Für Ihr Team bereitstellen.

printf '<!doctype html><meta charset="utf-8"><title>Hello</title><h1>Hello, artifact-site!</h1>' > hello.html

Einen Coding-Agenten anbinden

Wählen Sie den passenden Zugang für Ihren Agenten:

• Skill: npx skills add lexmount/artifact-site — installieren Sie den Agenten-Skill und geben Sie Ihrem Agenten die Server-URL.
• CLI: npm install -g @artifact-site/cli — erfordert Node 24+; Befehlsbeispiele finden Sie unten.
• MCP: https://your-server/mcp — verbinden Sie ChatGPT, Claude oder einen anderen MCP-Client über die OAuth-Anmeldung des Servers; keine CLI-Installation nötig. Ein Client, der nur lokale MCP-Server startet, kann stattdessen artifact-site mcp aus der CLI verwenden.

CLI und MCP erstellen standardmäßig private Werke ohne separate Freigabelinks. Auf Wunsch öffnet artifact-site visibility <slug> unlisted oder MCP artifact_site_set_visibility den Hauptlink.

_{Oder lassen Sie Ihren Coding-Agenten das erledigen. Mit dem Agenten-Leitfaden (/for-agents.md), der CLI oder dem MCP-Server ist „veröffentliche das und gib mir einen Link“ eine einzige Anweisung – und die Website lässt sich auf demselben Weg aktualisieren, durchsuchen und lesen.}

Geben Sie diese Anweisung an Claude Code, Cursor, Codex oder einen anderen Coding-Agenten, der URLs lesen kann, mit einer Serveradresse, die er erreichen kann. Die Startseite bietet außerdem einen Kopieren-Button mit bereits eingesetzter Serveradresse:

Veröffentliche die Ausgabe dieses Projekts auf artifact-site. Anleitung zum Veröffentlichen: https://your-server/for-agents.md

CLI-Beispiele (login erfordert OIDC):

artifact-site login --base https://your-server        # einmalige Geräteanmeldung
artifact-site publish dist/ --title "Q3 dashboard"    # veröffentlichen und Links zurückgeben
artifact-site find "quota"                           # nach Inhalt suchen
artifact-site read YOUR_SITE_SLUG                    # durch einen Site-Slug ersetzen, um dessen Text zu lesen

Für Ihr Team bereitstellen

Beginnen Sie mit .env.example und folgen Sie SELFHOST.md für eine Produktionsinstallation. Verwenden Sie für ARTIFACT_PUBLIC_URL eine stabile öffentliche Adresse: Anmelde-Callbacks, Prüfungen des Anfrage-Origins und die an Agenten übergebene Adresse leiten sich daraus ab:

• Setzen Sie eine erreichbare ARTIFACT_PUBLIC_URL und richten Sie einen Reverse-Proxy ein, oder setzen Sie ARTIFACT_WITH_CADDY=on mit ARTIFACT_DOMAIN, um Caddy und automatische Zertifikate zu aktivieren.
• Wählen Sie eine Veröffentlichungsrichtlinie. login erfordert OIDC; token bedient Skripte oder Agenten mit einem Bearer-Token; open erlaubt jedem, der den Dienst erreicht, das Veröffentlichen und eignet sich für vertrauenswürdige interne Netze. Anonymes Veröffentlichen unterstützt eigene Kontingente und Ablauffristen.
• Binden Sie Google oder einen OIDC-Provider wie Keycloak, Logto, Authentik, Okta oder Auth0 an. Konten besitzen Websites und Ordner; Agenten können per Geräteanmeldung langlebige Tokens erhalten. Das Standard-ARTIFACT_ENFORCE_OWNERSHIP=on aktiviert die kontobasierte Zugriffskontrolle, sobald OIDC konfiguriert ist. Tragen Sie die verifizierten Anmelde-E-Mail-Adressen der Administratoren in ARTIFACT_ADMIN_EMAILS ein, um die Admin-Konsole zu aktivieren.
• Aktivieren Sie die Office-Vorschau mit ARTIFACT_WITH_GOTENBERG=on. Die Admin-Konsole verwaltet Sperrungen, Kontingente, den Ablauf anonymer Websites und Richtlinienschalter. Legen Sie die Standard-Sichtbarkeit fest und planen Sie Backups.

Die App wird als ein Docker-Image ausgeliefert, im Einzelhost-Setup mit gebündeltem Postgres. Um ein verfügbares vorgefertigtes Image zu verwenden, setzen Sie ARTIFACT_IMAGE und führen make pull aus. make doctor prüft die Konfiguration; make backup und make restore übernehmen Sicherung und Wiederherstellung. Für mehrere Replikate, externes Postgres und S3-kompatiblen Speicher siehe DEPLOY.md.

So funktioniert es

• Anwendung und Speicher. Next.js liefert UI und API, Postgres speichert Metadaten, und Dateien liegen auf der lokalen Festplatte oder in S3-kompatiblem Speicher. Externe Datenbank und Objektspeicher ermöglichen mehrere App-Replikate.
• Unveränderliche Versionen. Jeder Upload und jede Bearbeitung schreibt eine neue Dateiversion und bewahrt frühere Inhalte. Optimistisches Sperren (expected_version) erkennt Konflikte bei gleichzeitigen Aktualisierungen.
• Isolation der Inhalte. Vorschauen verwenden Sandbox-iframes ohne allow-same-origin und eine restriktive CSP, um hochgeladene Inhalte von der Plattform zu isolieren. Pfadprüfungen und Entpackgrenzen schützen vor Path Traversal und ZIP-Bomben.

Architektur, Datenmodell und Anfrageabläufe finden Sie in ARCHITECTURE.md.

Dokumentation

Mitwirken

Die lokale Entwicklung erfordert Node 24+ und Docker:

npm install
make dev          # ein temporäres Postgres und den Entwicklungsserver starten
npm test          # Unit-Tests, keine externen Dienste nötig

Siehe CONTRIBUTING.md für den Beitragsprozess, das DCO-Sign-off und die CI-Anforderungen. Melden Sie Fehler und Ideen in den Issues; stellen Sie Fragen in den Discussions.

Wenn artifact-site Ihnen hilft, macht ein ⭐ es für andere leichter auffindbar. Ihr Team nutzt es bereits? Melden Sie sich in den Discussions — wir würden Sie gern als Nutzer aufführen.

Lizenz

Lizenziert nach Ihrer Wahl unter

• Apache License, Version 2.0 (LICENSE-APACHE)
• MIT-Lizenz (LICENSE-MIT)

Sofern Sie nicht ausdrücklich etwas anderes erklären, wird jeder Beitrag, den Sie absichtlich zur Aufnahme in dieses Projekt einreichen, wie oben doppelt lizenziert, ohne zusätzliche Bedingungen.

© 2025–2026 LexMount. Komponenten von Drittanbietern sind in NOTICE aufgeführt.

Dateipakete

Ordner- und ZIP/RAR/7z/TAR/TAR.GZ/TGZ-Uploads öffnen ein Dateiverzeichnis. HTML/HTM-Dateien werden per Klick in der Sandbox dargestellt. Archive sind standardmäßig auf 50 MiB komprimierte Größe begrenzt; die Originalbytes bleiben für Benutzer mit Quellcode-Exportberechtigung zum Download erhalten. Reine Leser dürfen das Paket nicht herunterladen. Ordner werden als ZIP exportiert, einschließlich leerer Verzeichnisse, sofern der Upload-Client sie erfassen kann. Bestehende Website-Versionen und ältere API-Modi behalten ihr Verhalten.

Details zu Bereitstellung und Archivlaufzeit.