Agile Developer Hilfe-Center › Agile Vibes

Python-Backends und Datenbanken

FastAPI, Flask und Django in Agile Vibes, automatische PostgreSQL- und MongoDB-Datenbanken, Migrationen mit alembic.

Agile Vibes führt neben Node-Apps auch Python-Backends aus und legt die passende Datenbank automatisch an.

Unterstützte Python-Frameworks

  • FastAPI: Start in der Vorschau: uvicorn mit --reload; Start nach Veröffentlichung: uvicorn mit Proxy-Headern
  • Flask: Start in der Vorschau: flask run --debug; Start nach Veröffentlichung: gunicorn, wenn vorhanden, sonst flask run
  • Django: Start in der Vorschau: manage.py migrate, dann runserver; Start nach Veröffentlichung: wie erkannt

Installiert wird in eine eigene virtuelle Umgebung (.venv) mit uv aus requirements.txt oder pyproject.toml. Python 3.12 ist in der Sandbox vorhanden.

So erkennt Agile Vibes Ihr Backend

  • Abhängigkeiten aus requirements.txt, pyproject.toml oder Pipfile.
  • Die App-Variable, etwa app = FastAPI() in main.py, sonst wird main:app angenommen.
  • Ports aus Startbefehlen, Dockerfile oder Procfile.
  • Variablen aus os.environ, os.getenv und settings-Klassen.

Datenbanken

Agile Vibes legt je Projekt eine eigene Datenbank mit eigenem Benutzer an. Andere Projekte sehen sie nicht.

  • psycopg, psycopg2, asyncpg, pg8000, SQLAlchemy/SQLModel/alembic mit Postgres-URL: Datenbank: PostgreSQL; Variable (Standard): DATABASE_URL = {{db:postgres:url}}
  • pymongo, motor, beanie, mongoengine, odmantic: Datenbank: MongoDB; Variable (Standard): MONGODB_URI = {{db:mongo:url}}
  • Node: pg, prisma (Postgres), mongoose, mongodb: Datenbank: wie oben; Variable (Standard): wie oben

Nutzt Ihre App einen anderen Variablennamen (etwa POSTGRES_URL oder MONGO_URL) und steht er in der .env.example, setzt Agile Vibes den Platzhalter dort ein. Findet Agile Vibes keine passende Variable, legt es DATABASE_URL bzw. MONGODB_URI an und zeigt einen Hinweis.

Migrationen und alembic

  • Liegt eine alembic.ini im Backend, führt der Startbefehl vor dem Start alembic upgrade head aus.
  • Ausnahme: Legt die App ihre Tabellen beim Start selbst an (metadata.create_all(...) oder ähnlich), wird alembic nicht vor dem Start ausgeführt. Der Grund: Auf einer leeren Datenbank scheitert die alembic-Kette dann oft, weil die erste Migration keine Tabellen anlegt. Sie sehen dazu den Hinweis „Die App legt ihre Tabellen beim Start selbst an (create_all). alembic wird deshalb nicht vor dem Start ausgeführt.“
  • Django: Vor jedem Start läuft manage.py migrate --noinput.
  • Neue Tabellen oder Spalten legt die KI über die Migrationen Ihres Projekts an (Alembic, Prisma, Drizzle usw.), sonst über ein wiederholbares Setup-Skript.

Daten ansehen

Im Editor-Tab Datenbank sehen Sie Tabellen (bzw. Sammlungen) und Spalten. Ein Klick zeigt die ersten 100 Zeilen. Eigene Abfragen sind nur lesend, zum Beispiel select * from bestellungen where status = 'offen' limit 20 oder bei MongoDB ein Filter wie {"status": "offen"}. Ausführen mit Ausführen oder Strg+Enter.

Größen je Tarif

  • Free: 200 MB
  • Start: 1 GB
  • Pro: 5 GB
  • Business: 20 GB

Tipps

  • Lesen Sie die Datenbank-URL immer aus der Umgebung. Zugangsdaten im Code sind unnötig und unsicher.
  • Für Django mit SQLite: Agile Vibes erkennt SQLite, die Datei wird bei Veröffentlichungen aber nicht dauerhaft gespeichert. Stellen Sie für echte Daten auf PostgreSQL um; die KI hilft dabei.
  • Nach neuen Abhängigkeiten in requirements.txt startet die KI den Teil neu. Selbst geht das im Tab Logs mit dem Neustart-Knopf.

Typische Fehler

  • „nur Pipfile gefunden“: Ergänzen Sie eine requirements.txt oder passen Sie den Installationsbefehl unter Einstellungen › Teile an.
  • „keine FastAPI-App gefunden, Start mit main:app angenommen“: Passen Sie den Startbefehl an, zum Beispiel auf app.main:app.
  • alembic bricht mit „relation does not exist“ ab: Die erste Migration setzt bestehende Tabellen voraus. Lassen Sie die App ihr Schema mit create_all anlegen oder bitten Sie die KI, eine Basis-Migration zu ergänzen.
  • „MySQL wird nicht angeboten“: Verfügbar sind PostgreSQL und MongoDB.

Häufige Fragen

Wie komme ich an meine Daten, wenn ich umziehe?
Code laden Sie als ZIP herunter oder übertragen ihn per Git. Die Inhalte Ihrer Datenbanken erreichen Sie über die Zugangsdaten im Projekt; bei einem vollständigen Export hilft Ihnen unser Support über Hilfe & Support.

Kann ich selbst eine Datenbank anlegen?
Ja. Im Tab Datenbank mit Postgres anlegen oder MongoDB anlegen. Die Zugangsdaten landen automatisch in den Variablen.

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.