> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Projekte und Einrichtung der Umgebung

> Erstellen Sie ein Cloud-Projekt oder ein lokales Projekt, lassen Sie die KI die Projektumgebung einrichten, sehen Sie Sitzungen, Commits, Dateien und Website-Vorschauen auf der Projektseite und teilen, exportieren, konfigurieren oder löschen Sie Projekte.

Ein **Projekt** besteht aus einer Reihe von Codequellen und den zugehörigen Umgebungseinstellungen. Eine Quelle kann ein GitHub-Repository, ein auf den Cloud-Server hochgeladener Ordner oder ein Ordner auf Ihrem Computer sein. Sitzungen können innerhalb eines Projekts oder außerhalb jedes Projekts laufen.

## Cloud-Projekte und lokale Projekte

* **Cloud-Projekt**: Der Code liegt auf Ihrem [Cloud-Server](https://docs.aihubmix.com/de/cloud/environments/cloud-host.md). Es gibt drei Quellen: neu erstellen, aus GitHub importieren oder ein lokales Projekt hochladen. Erfordert Plus.
* **Lokales Projekt**: Mit einem Ordner auf einem Ihrer Computer verknüpft. Sitzungen laufen auf diesem Computer. Siehe [Auf Ihrem Gerät ausführen](https://docs.aihubmix.com/de/cloud/environments/your-device.md). Dateien werden nicht hochgeladen, und es wird kein Cloud-Server benötigt.

Die Seitenleiste zeigt Projekte nach diesen Typen in zwei Abschnitten an. Ein Projekt wechselt nach dem Erstellen nie in den anderen Abschnitt. In der Web-App oder auf einem anderen Computer sehen Sie lokale Projekte und deren Sitzungen und können darin neue Sitzungen starten, aber Dateien und Commits, die nicht in die Cloud hochgeladen wurden, sehen Sie nicht.

![Projektliste](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/projects.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=163abfbe35d19fd703de8fb5a1a5b1fd)

Die Projektseite listet alle Projekte im Arbeitsbereich auf

## Projekt erstellen

Klicken Sie auf **+** an einer Abschnittsüberschrift in der Seitenleiste, auf **New project** auf der Projektseite oder auf **New project** im Projektmenü oberhalb des Eingabefelds für eine neue Sitzung. Wenn Sie ein Cloud-Projekt ohne Plus erstellen, öffnet sich zuerst das Abonnementfenster. Klicken Sie nach dem Abschluss auf Continue, um zum Erstellungsfenster zurückzukehren. Bereits ausgewählte Repositorys bleiben erhalten.

### Neu erstellen

**1. Namen eingeben**

Bis zu 64 Zeichen. Bleibt das Feld leer, wird `my-app` verwendet.

**2. Startvorlage wählen**

Zum Beispiel Blank, Node · TypeScript, Next.js oder Python, wie in der App angezeigt.

**3. Erstellen**

Wählen Sie bei Bedarf **Create a private GitHub repository** (erfordert ein verbundenes GitHub-Konto) und klicken Sie dann auf **Create project**.

### Aus GitHub importieren

**1. Repositorys wählen**

Wählen Sie ein oder mehrere Repositorys aus. Bei mehreren ist das erste das Haupt-Repository, die übrigen werden zusammen mit ihm in das Projekt geklont.

**2. Erstellung starten**

Klicken Sie auf **Get started**. Danach gelangen Sie zur Seite für eine neue Sitzung, auf der dieses Projekt ausgewählt ist.

![Neues Projekt: aus GitHub importieren](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/new-project.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=c08c4b54fadb27957fe5757eb30d873c)

Repositorys aus GitHub importieren

Fehlt ein Repository in der Liste, klicken Sie auf **Configure access**, um die Autorisierung auf GitHub anzupassen, und nach der Rückkehr auf **Refresh**. Wenn Sie GitHub noch nicht verbunden haben, lesen Sie [Konnektoren](https://docs.aihubmix.com/de/cloud/integrations/connectors.md).

### Lokales Projekt hochladen

Ziehen Sie einen Ordner in das Fenster oder klicken Sie auf **Choose folder…**, bestätigen Sie Dateianzahl und Größe und klicken Sie dann auf **Get started**. Für Uploads gelten folgende Grenzen: insgesamt 2 GiB, bis zu 50.000 Dateien und 100 MiB pro Datei. In `.gitignore` aufgeführte Inhalte, `node_modules`, `.git`, Dateien im Stil von `.env` sowie Zugangsdaten, private Schlüssel und Zertifikate werden automatisch ausgeschlossen.

Schlägt ein Upload fehl oder wird er abgebrochen, wird der bereits hochgeladene Teil nicht behalten, und ein erneuter Versuch beginnt von vorn. Hochgeladene Projekte haben kein Remote-Repository, daher werden Änderungen als Patch ausgeliefert.

> [!NOTE]
>
> Mobile Browser können keine Ordner auswählen. Deshalb können Sie kein lokales Projekt von einem Smartphone hochladen.

### Ordner auf Ihrem Computer verknüpfen

**1. Ordner wählen**

Klicken Sie im Fenster für ein neues lokales Projekt unter dem Quellordner auf **Add**. Der Projektname wird mit dem Ordnernamen vorausgefüllt und kann geändert werden.

**2. Erstellen**

Klicken Sie auf **Create project**, um zur Seite für eine neue Sitzung zu gelangen. Als Ausführungsort ist standardmäßig dieser Computer eingestellt.

Zu weit gefasste Ordner wie Ihren Benutzerordner oder Ordner, für die Sie keine Leserechte haben, können Sie nicht wählen. Nach dem Erstellen des Projekts können Sie in den Projekteinstellungen weitere Ordner auf demselben Computer hinzufügen.

> [!NOTE]
>
> Lokale Projekte können nur in der Desktop-App erstellt werden.

## Umgebung eines Cloud-Projekts einrichten

Die Projektumgebung umfasst das Setup-Skript, den Startbefehl sowie die Secrets und Umgebungsvariablen, die das Projekt verwendet. Die Einrichtung ist optional. Sie können Sitzungen starten, sobald das Projekt erstellt ist. Lokale Projekte verwenden die Umgebung des Computers und überspringen diesen Schritt.

**1. Seite zur Einrichtung der Umgebung öffnen**

Klicken Sie unter **Project settings › Environment** auf die Bearbeiten-Schaltfläche. Die Seite zur Einrichtung der Umgebung ist eine eigene Seite im Projekt und erscheint nicht in der Sitzungsliste.

**2. Warten, bis die KI einen Entwurf erstellt**

Die KI liest das Repository und erstellt das Setup-Skript, den Startbefehl und die benötigten Secrets und Variablen. Bis Sie die Prüfung abgeschlossen haben, wird kein Skript ausgeführt.

**3. Die drei Prüfschritte abschließen**

Bestätigen Sie in dieser Reihenfolge das Setup-Skript und den Startbefehl, tragen Sie die Secrets ein und tragen Sie die Umgebungsvariablen ein. Wenn die Pflichtfelder ausgefüllt sind, klicken Sie auf **Finish review**. Wenn Sie die Werte noch nicht haben, klicken Sie auf **Respond later**. Bereits eingegebene Werte bleiben erhalten.

**4. Veröffentlichen**

Die KI führt das Setup-Skript auf dem Cloud-Server aus. Ist es erfolgreich, klicken Sie auf **Publish to cloud server** und dann auf **Start a task**, um zu einer neuen Sitzung zu gelangen. Schlägt es fehl, klicken Sie auf **Retry** oder **Edit environment**. Ein Fehlschlag hindert Sie nicht daran, Sitzungen zu starten.

Im Eingabefeld unten auf der Seite können Sie weitere Anforderungen hinzufügen, und die KI konfiguriert die Umgebung entsprechend neu. Wenn Sie eine veröffentlichte Umgebung ändern, veröffentlichen Sie sie erneut, damit die Änderungen wirksam werden. Senden Sie keine Secrets über das Eingabefeld. Tragen Sie sie in den Prüfschritten oder in den Secrets-Einstellungen ein.

## Fortschritt auf der Projektseite prüfen

Öffnen Sie ein Projekt, um Folgendes zu sehen:

* **Letzte Sitzungen**: Laufende Sitzungen und Sitzungen, die auf Ihre Freigabe warten, sind hervorgehoben. Klicken Sie auf **View all**, um alle Sitzungen dieses Projekts zu sehen.
* **Commits**: Die letzten Commits im aktuellen Branch. Öffnen Sie einen Commit, um die geänderten Dateien sowie hinzugefügte und entfernte Zeilen zu sehen.
* **Dateien**: Enthält ein Ordner eine README, wird sie direkt angezeigt. Markdown- und ähnliche Dateien lassen sich zwischen Vorschau und Quelltext umschalten und können kopiert oder geteilt werden. Sensible Dateien wie `.env` und private Schlüssel werden nicht angezeigt.
* **Website-Vorschauen**: Dienste, auf denen dieses Projekt auf dem Cloud-Server lauscht, zum Beispiel `localhost:3000`. Klicken Sie auf **Open**, um die Vorschau in der App anzuzeigen. Ein Eintrag erscheint, sobald Sie den Agent einen Entwicklungsserver starten lassen. Vorschauen sind nicht verfügbar, wenn der Cloud-Server nicht läuft.

## Vorschau oder Datei teilen

**1. Teilen öffnen**

Klicken Sie in einer Website-Vorschau auf **Share** oder in der Dateiansicht auf **Share file**.

**2. Zugriff und Ablauf festlegen**

Wählen Sie Nur ich, Jeder mit dem Link (Standard) oder Öffentlich. Die Gültigkeit beträgt 1 bis 30 Tage (standardmäßig 7 Tage).

**3. Link kopieren**

Klicken Sie auf **Create link** und dann auf **Copy link**.

> [!WARNING]
>
> Der Link wird nur einmal angezeigt und kann nach dem Schließen nicht erneut angesehen werden. Kopieren Sie ihn sofort. Bevor Sie Öffentlich wählen, vergewissern Sie sich, dass der Inhalt veröffentlicht werden darf.

Unter **My shares** können Sie einen Link widerrufen (er funktioniert sofort nicht mehr) oder einen abgelaufenen Link erneut teilen. Freigaben, die das tägliche Datenverkehrslimit überschreiten, werden pausiert und am nächsten Tag fortgesetzt.

## Projekteinstellungen ändern

Öffnen Sie oben rechts auf der Projektseite **Project settings** oder im Projektmenü **Edit**. Klicken Sie auf **Save**, um Ihre Änderungen zu übernehmen.

* **Name und Beschreibung**: Namen umfassen 1 bis 64 Zeichen.
* **Repositorys**: Das Haupt-Repository kann nicht entfernt werden. Sie können den neuesten Stand von GitHub abrufen. Klicken Sie auf **Add repository** und geben Sie `owner/name` ein, um ein weiteres Repository daneben zu klonen.
* **Basis-Branch**: Sitzungen erstellen ihre Arbeits-Branches von diesem Branch, und Pushes und PRs zielen auf ihn.
* **Auslieferungsverhalten**: PR erstellen (Standard), Branch pushen oder benutzerdefiniert. **Commit author** kann AIHubMix Agent (Standard) oder Ihr GitHub-Konto sein. Zu Commits und PRs lesen Sie [Ergebnisse prüfen und ausliefern](https://docs.aihubmix.com/de/cloud/sessions/review-and-deliver.md).

### Secrets und Umgebungsvariablen verwalten

Fügen Sie sie unter **Settings › Workspace › Secrets & variables** hinzu und bearbeiten Sie sie dort. Jedes Projekt hat einen eigenen Satz sowie einen Satz, den alle Projekte gemeinsam nutzen. Bei gleichen Namen hat der Projektwert Vorrang.

* Secrets werden verschlüsselt gespeichert, und die KI kann die Originalwerte nicht sehen. Auch beim Bearbeiten sehen Sie den Originalwert nicht; geben Sie einen neuen Wert ein, um ihn zu überschreiben.
* Klicken Sie auf **Bulk add**, um `.env`-Inhalte direkt einzufügen, ein `KEY=value` pro Zeile. Namen, die KEY, TOKEN, SECRET oder PASSWORD enthalten, werden als Secrets gespeichert.
* Beim Löschen gibt es keine zweite Bestätigung. Laufende Umgebungen müssen neu gestartet werden, damit Änderungen wirksam werden.
* Bei der Ausführung auf Ihrem Gerät legen die Geräteeinstellungen fest, welche Secrets des Arbeitsbereichs diesem Computer zur Verfügung stehen. Siehe [Auf Ihrem Gerät ausführen](https://docs.aihubmix.com/de/cloud/environments/your-device.md).

### Projekt exportieren

Klicken Sie in den Projekteinstellungen auf **Export…** und dann auf **Export**. Wenn die Paketierung abgeschlossen ist, klicken Sie auf **Download archive**. Das Archiv enthält keine `.env`, Secrets, Abhängigkeiten oder Caches. Der Cloud-Server muss laufen, und nur der Projektinhaber kann exportieren.

## Projekt löschen

Klicken Sie im Projektmenü oder in den Projekteinstellungen auf **Delete project…** und bestätigen Sie. Die Sitzungen im Projekt werden archiviert und können unter **Settings › Workspace › Archived chats** wiederhergestellt werden. Gibt es nicht gepushte Änderungen, werden sie aufgelistet, und Sie müssen zum Löschen den Projektnamen eingeben.

> [!WARNING]
>
> Beim Löschen werden die Cloud-Umgebung, die Dateien und die Abhängigkeits-Caches des Projekts entfernt. Dies kann nicht rückgängig gemacht werden. Ordner lokaler Projekte auf Ihrem Computer sind nicht betroffen.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.