CrewAI GUI

Darmowe, open-source'owe webowe GUI dla frameworka CrewAI.

Twórz zespoły agentów AI (crews) wizualnie — bez pisania kodu — i uruchamiaj je lokalnie na własnym komputerze. Alternatywa dla płatnych, chmurowych narzędzi: wszystko działa u Ciebie, klucze API nigdzie nie wyciekają, a projekt jest w 100% darmowy (licencja MIT).

Funkcje

• Wizualny kreator crew — twórz agentów (rola, cel, backstory, model LLM, temperatura, narzędzia) i zadania (opis, oczekiwany wynik, kontekst między zadaniami) w przeglądarce
• Procesy sequential i hierarchical — z wyborem modelu managera
• Uruchamianie jednym kliknięciem + logi na żywo — postęp crew streamowany przez WebSocket prosto do przeglądarki
• Zmienne wejściowe — użyj {zmiennej} w opisie zadania, a GUI zapyta o wartość przed startem
• Historia uruchomień — każdy run z pełnymi logami i wynikiem zapisany w lokalnej bazie SQLite
• Konfiguracja LLM z GUI, z naciskiem na darmowe opcje — Groq, OpenRouter (modele :free), Google Gemini, Cerebras, Mistral, NVIDIA NIM oraz w pełni darmowe, lokalne modele przez Ollama — każdy z linkiem do darmowej rejestracji wprost w zakładce Ustawienia. OpenAI/Anthropic (płatne) też dostępne. Pole „wpisz model ręcznie" pozwala użyć dowolnego innego modelu wspieranego przez CrewAI/LiteLLM.
• Narzędzia agentów — wyszukiwarka Google (Serper), scraper stron, RAG po stronie WWW, odczyt plików i katalogów
• Eksport / import YAML — przenoś crews między GUI a zwykłymi projektami CrewAI w kodzie

Instalacja (Windows)

Opcja A — instalator .exe (zalecane, nic nie musisz mieć zainstalowane)

1. Pobierz CrewAI-GUI-Setup.exe z najnowszego wydania.
2. Uruchom go i przejdź przez kreatora (instalacja per-user, bez uprawnień administratora).
3. Po zakończeniu aplikacja odpali się sama i otworzy w przeglądarce pod http://localhost:8000. Kolejne uruchomienia — ikona „CrewAI GUI" na Pulpicie / w Menu Start.

Ten instalator zawiera wbudowanego Pythona i wszystkie zależności (w tym CrewAI) — nie potrzebujesz osobno instalować Pythona ani Node.js. Zamknięcie zminimalizowanego okna „CrewAI GUI - serwer" zatrzymuje aplikację. Standardowy odinstalowywacz Windows (Ustawienia → Aplikacje) usuwa program; Twoje zapisane crews i klucze API zostają nietknięte, chyba że ręcznie skasujesz folder instalacji.

Opcja B — skrypt instalacyjny (buduje z kodu źródłowego)

Jeśli wolisz, żeby instalator sam pobrał najnowszy kod i zbudował go lokalnie (albo chcesz go potem rozwijać):

1. Pobierz projekt (zielony przycisk Code → Download ZIP na GitHubie, albo git clone) i rozpakuj gdziekolwiek na dysku.
2. Kliknij dwukrotnie Zainstaluj.bat.
3. Poczekaj, aż instalator sprawdzi/zainstaluje Pythona i Node.js (jeśli ich nie masz — przez winget, może pojawić się okno zgody Windows), zainstaluje zależności i zbuduje interfejs. Na koniec utworzy skrót „CrewAI GUI" na Pulpicie i w Menu Start.
4. Odtąd uruchamiasz aplikację jednym kliknięciem w ten skrót (albo plik Uruchom CrewAI GUI.bat) — otworzy się w przeglądarce pod http://localhost:8000.

Wymaga jednorazowo połączenia z internetem (pobranie zależności) oraz uprawnień do instalacji Pythona/Node.js, jeśli ich nie masz. Wszystko instaluje się lokalnie w folderze projektu.

Oba instalatory wymagają PowerShell 5.1+ (jest domyślnie w każdym Windows 10/11). Jeśli podwójne kliknięcie w Zainstaluj.bat nic nie robi, kliknij prawym przyciskiem → Uruchom jako administrator.

Wolisz ręcznie / masz Linuksa lub macOS / chcesz rozwijać kod? Zobacz instrukcję deweloperską niżej.

Szybki start (deweloperskie, dwa terminale)

Wymagania: Python 3.10–3.13 (3.14 nie jest jeszcze wspierany przez CrewAI) oraz Node.js 18+.

Windows + kilka wersji Pythona? Utwórz venv konkretną wersją: py -3.12 -m venv .venv.

git clone https://github.com/caytec/crewai-gui.git
cd crewai-gui

1. Backend

cd backend
python -m venv .venv
# Windows:
.venv\Scripts\activate
# Linux/macOS:
source .venv/bin/activate

pip install -r requirements.txt
copy .env.example .env    # Linux/macOS: cp .env.example .env
uvicorn app.main:app --reload --port 8000

2. Frontend (drugi terminal)

cd frontend
npm install
npm run dev

Otwórz http://localhost:5173 — gotowe. W tym trybie działają dwa procesy (Vite proxy'uje /api na :8000) z hot-reloadem, wygodne do rozwijania kodu.

Na Windows możesz zamiast tego uruchomić scripts\start-dev.bat, który odpala oba serwery naraz.

Chcesz jednego procesu na jednym porcie (jak w trybie jednoklikowym)? Zbuduj frontend (npm run build w frontend/) i odpal tylko backend (uvicorn app.main:app --port 8000) — FastAPI wykryje frontend/dist i zacznie serwować całe GUI pod http://localhost:8000, bez osobnego procesu Node.

Klucze API

Wejdź w Ustawienia w GUI i wklej klucz przynajmniej jednego dostawcy LLM (np. OpenAI albo Anthropic). Klucze zapisują się w lokalnej bazie backend/data/app.db — nie opuszczają Twojego komputera.

Nie chcesz płacić za API? Zainstaluj Ollama, pobierz model (ollama pull llama3.1) i wybierz w kreatorze agenta model „Ollama … (lokalnie)". Zero kluczy, zero chmury.

Jak to działa

┌────────────────┐     REST + WebSocket      ┌─────────────────┐
│  React (Vite)  │ ◄───────────────────────► │  FastAPI        │
│  localhost:5173│                           │  localhost:8000 │
└────────────────┘                           └────────┬────────┘
                                                      │
                                             ┌────────▼────────┐
                                             │  CrewAI         │
                                             │  (Twoje crews)  │
                                             └────────┬────────┘
                                                      │
                                     SQLite (crews, runs, logi, klucze)

• Backend (FastAPI) trzyma definicje crews w SQLite i tłumaczy je na obiekty crewai.Crew / Agent / Task przy każdym uruchomieniu.
• Logi na żywo lecą z callbacków CrewAI przez wewnętrzny broadcaster do WebSocketu.
• Frontend (React + Vite) to czysty SPA. W dev module proxy'owany jest do backendu przez Vite; po zbudowaniu (npm run build) backend serwuje go sam z frontend/dist — dokładnie tak działa jednoklikowy instalator na Windows.

Pierwsza crew w 2 minuty

1. Nowa Crew → nazwij ją np. „Research rynku"
2. Dodaj agenta: rola Analityk rynku, cel Znajdować rzetelne informacje o {temat}, model wg uznania
3. Dodaj zadanie: opis Przeanalizuj temat: {temat} i wypisz 5 kluczowych wniosków, oczekiwany wynik Lista 5 wniosków po polsku
4. ▶ Uruchom Crew → wpisz wartość temat → obserwuj logi na żywo → odbierz wynik

Struktura projektu

Zainstaluj.bat            # jednoklikowy instalator ze zrodel (Windows)
Uruchom CrewAI GUI.bat    # jednoklikowy start (tworzy tez skrot na Pulpicie)
scripts/
  install.ps1              # logika instalatora ze zrodel (Python, Node, build, skroty)
  run-server.bat           # wewnetrzny - startuje backend w tle
  start-dev.bat / .sh       # tryb deweloperski (dwa procesy, hot-reload)
installer/
  CrewAIGUI.iss            # skrypt Inno Setup - samodzielny instalator .exe
  build.ps1                # buduje embeddable Python + zaleznosci + frontend + .exe
  run.bat                  # launcher spakowany wewnatrz instalatora .exe
backend/
  app/
    main.py            # FastAPI app + CORS + routery + serwowanie frontend/dist
    models.py          # SQLAlchemy: Crew, Agent, Task, Run, RunLog, Setting
    schemas.py         # Pydantic – kontrakt API
    routers/           # crews, runs (+WebSocket), settings, export YAML
    services/
      crewai_runner.py # mapowanie DB → obiekty crewai + kickoff
      run_manager.py   # pub/sub logów na żywo
      catalog.py       # katalog modeli LLM i narzędzi
frontend/
  src/
    pages/             # Dashboard, CrewEditor, RunView, RunsHistory, Settings
    api/client.js      # klient REST + WebSocket

FAQ

Czy to jest oficjalny produkt CrewAI? Nie. To niezależny, społecznościowy projekt open source zbudowany na otwartym frameworku CrewAI (MIT). Nie jest powiązany z CrewAI Inc. ani ich płatną chmurą.

Czy moje dane/klucze gdzieś wyciekają? Nie. Wszystko (crews, historia, klucze API) trzymane jest lokalnie w backend/data/app.db. Jedyne wychodzące połączenia to te, które wykonują sami agenci (do wybranego dostawcy LLM i narzędzi).

Jakie modele mogę używać za darmo? Groq, OpenRouter (modele z sufiksem :free), Google Gemini, Cerebras, Mistral i NVIDIA NIM mają darmowy próg — w zakładce Ustawienia każdy ma link do bezpłatnej rejestracji (bez karty płatniczej). Ollama to lokalne modele, w 100% za darmo i offline. OpenAI/Anthropic są dostępne, ale płatne. Listę można rozszerzyć w backend/app/services/catalog.py, a w kreatorze agenta opcja „Inny model (wpisz ręcznie)" pozwala użyć dowolnego modelu wspieranego przez CrewAI/LiteLLM bez zmian w kodzie.

Czy mogę używać crews z GUI w zwykłym kodzie Pythona? Tak — użyj „Eksport YAML" i przenieś definicje do swojego projektu CrewAI.

Budowanie instalatora .exe samodzielnie

Wymaga Inno Setup 6 oraz lokalnie zainstalowanego Pythona 3.10-3.13 i Node.js (tylko do zbudowania paczki — końcowy .exe nie wymaga niczego od użytkownika):

installer\build.ps1

Wynik: installer\dist\CrewAI-GUI-Setup.exe. Skrypt pobiera embeddable Python, instaluje w nim zależności backendu, buduje frontend i kompiluje wszystko przez Inno Setup.

Rozwój / Contributing

PR-y i issues są mile widziane! Pomysły na rozwój:

• Wizualny graf przepływu zadań (drag & drop)
• Anulowanie działającej crew
• Wsparcie dla CrewAI Flows
• Więcej narzędzi z crewai-tools
• Tryb multi-user z logowaniem
• Docker Compose do wdrożenia jedną komendą

Licencja

MIT — rób z tym co chcesz, także komercyjnie.