Agile Developer Hilfe-Center › Agile Vibes

Bestehende App importieren

Repository von GitHub, Agile Git, einer Git-URL oder als ZIP holen, prüfen, starten und per Chat weiterbauen.

Mit dem Import-Assistenten holen Sie eine bestehende App in Agile Vibes. Danach läuft sie in der Sandbox, und Sie ändern sie per Chat wie eine neue App.

Was sich importieren lässt

  • Node: Next.js, React mit Vite, Express, NestJS, Fastify (auch Hono und Koa werden erkannt).
  • Python: FastAPI, Flask, Django.
  • Aufbau: ein einzelnes Repository, ein Monorepo mit zum Beispiel frontend/ und backend/, oder mehrere Repositorys (etwa Frontend und Backend getrennt).
  • Datenbanken: PostgreSQL und MongoDB werden automatisch angelegt. MySQL wird nicht angeboten.

Quellen

  • GitHub: Wann: Öffentlich oder mit Token; Hinweis: Für private Repositorys „Privates Repository? Token angeben“ wählen. Ein fein granuliertes Token mit Leserecht genügt.
  • Agile Git: Wann: git.agiledeveloper.de; Hinweis: Einmal Mit Agile Git verbinden, dann alle Repositorys aus einer Liste wählen.
  • Git-URL: Wann: Jeder https-Git-Server; Hinweis: Adresse wie https://git.beispiel.de/team/projekt.git, bei Bedarf mit Token.
  • ZIP-Datei: Wann: Ohne Git; Hinweis: Bis 200 MB, ohne node_modules, .venv und Build-Ordner. Höchstens eine ZIP-Datei je Import.

Das Token gilt nur für diesen einen Import und landet nie im Repository.

Schritt für Schritt

  1. Öffnen Sie /app und klicken Sie auf Bestehende App importieren (oder direkt /app/importieren).
  2. Schritt „Quellen“: Wählen Sie GitHub, Agile Git, Git-URL oder ZIP-Datei und geben Sie die Adresse an. Das zweite Feld neben der Adresse ist der Branch (leer lassen für den Standard-Branch).
  3. Gehört ein weiteres Repository dazu, klicken Sie auf Weiteres Repository hinzufügen (bis zu 5). Mehr dazu in Frontend und Backend aus zwei Repositorys.
  4. Klicken Sie auf Analysieren. Geklont wird auf unserem Sandbox-Server in Nürnberg, isoliert mit gVisor.
  5. Schritt „Analyse“: „Wir sehen uns Ihren Code an …“. Agile Vibes erkennt Frameworks, Paketmanager, Befehle, Ports, Variablen und den Datenbank-Bedarf.
  6. Schritt „Prüfen“: Unter „Das haben wir erkannt“ sehen Sie: eine Grafik, wie Frontend, Backend und Datenbank verbunden sind; Hinweise (zum Beispiel zu Ports, SQLite oder einer eingecheckten .env-Datei); je Teil eine Karte mit Installieren, Start, Build und Port, die Sie ändern können; die Variablen des Teils (automatisch verknüpfte Werte für Backend-Adresse und Datenbank sind schon gesetzt, geheime Werte tragen Sie hier ein); welche Datenbank angelegt wird („PostgreSQL wird angelegt“).
  7. Unten steht „Noch offen: …“, solange Pflicht-Geheimnisse fehlen. Sind alle ausgefüllt („Alles bereit“), klicken Sie auf Installieren und starten.
  8. Schritt „Start“: Abhängigkeiten werden installiert, danach starten die Teile. Die Ausgabe sehen Sie live. Das dauert beim ersten Mal ein bis drei Minuten.
  9. „Ihre App läuft“: Klicken Sie auf Zum Editor. Ab jetzt ändern Sie die App per Chat.

Sie können den Assistenten schließen; der Import läuft weiter. In der Projektübersicht steht die Karte dann auf „Import läuft“, und ein Klick führt zurück zum Assistenten. Mit Push-Benachrichtigungen meldet sich Agile Vibes, wenn der Import fertig ist.

Wenn der Start fehlschlägt

Der Assistent zeigt die Fehlermeldung und den Link Mit KI reparieren. Er öffnet den Editor und schickt der KI automatisch die Bitte, die Logs zu prüfen und den Start zu reparieren. Die KI kann Befehle anpassen, fehlende Pakete installieren und Konfiguration ändern. Das kostet KI-Guthaben wie jede andere Antwort.

Tipps

  • Legen Sie eine .env.example mit allen Variablennamen ins Repository. Agile Vibes übernimmt daraus die Namen und Beispielwerte.
  • Liegt eine echte .env mit Werten im Repository, übernehmen wir nur die Namen, nicht die Werte. Prüfen Sie in diesem Fall, ob dort Geheimnisse stehen, und ändern Sie diese.
  • Prüfen Sie den Port je Teil. Agile Vibes vergibt freie Ports und ersetzt im Startbefehl den Platzhalter {{port}}.
  • Feste Adressen wie http://localhost:4000 im Frontend sollten über eine Variable laufen (zum Beispiel NEXT_PUBLIC_API_URL). Dann verknüpft Agile Vibes sie automatisch mit dem Backend.

Typische Fehler

  • „kein startbares Projekt erkannt“: Es gibt kein package.json mit Framework und keine requirements.txt. Prüfen Sie, ob Sie das richtige Repository oder den richtigen Branch gewählt haben. Einen Teil von Hand legen Sie über die API an oder mit Hilfe des Supports.
  • „Port … ist schon belegt, verwendet wird …“: Nur ein Hinweis. Agile Vibes hat einen anderen Port gewählt und den Startbefehl angepasst.
  • „Ein Next-Rewrite zeigt fest auf localhost“: Ändern Sie die Rewrite-Regel auf die Backend-Variable oder lassen Sie das die KI machen.
  • „SQLite erkannt“: Die Datenbank liegt als Datei im Projekt und wird bei Veröffentlichungen nicht dauerhaft gespeichert. Für echte Daten besser PostgreSQL nutzen.
  • Private Repositorys schlagen fehl: Token fehlt oder hat kein Leserecht auf „Contents“.
  • Free-Tarif und mehrere Teile: Im Tarif Free ist ein Teil je Projekt möglich, ab Start drei, ab Pro acht.

Häufige Fragen

Was passiert mit meinem Original-Repository?
Nichts. Agile Vibes arbeitet mit einer Kopie. Änderungen laden Sie bei Bedarf über das Git-Menü wieder hoch (siehe Git verbinden, hochladen und aktualisieren).

Kann ich alle Einstellungen später noch ändern?
Ja. Befehle, Ports und Variablen jedes Teils ändern Sie im Editor unter Einstellungen › Teile, Geheimnisse unter Einstellungen › Geheimnisse.

Wird die Git-Historie übernommen?
Ja, die letzten 50 Commits werden mitgeklont. Der Import selbst erscheint als Version der Art „Import“.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 14. Oktober 2026

Weitere Artikel zu Agile Vibes

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.