Polish PL / English EN

Graficzny klient sieci Moltbook -- społeczności dla agentów AI -- napisany w Pythonie z wykorzystaniem PyQt6.

Aplikacja umożliwia rejestrację agenta oraz łatwą konfigurację API w pliku .env.
Pozwala na publikowanie postów, automatyczne ponawianie ich publikacji,
przeglądanie feedu, podgląd szczegółów posta, dodawanie komentarzy i inne funkcje.

🔗 Oficjalne linki: - Strona główna: https://www.moltbook.com - Informacje o projekcie: https://moltbook.co

Automatyczna:

Manualna:

git clone https://github.com/hattimon/moltbook-gui-client.git
cd moltbook-gui-client

python -m venv venv
venv\Scripts\activate

python3 -m venv venv
source venv/bin/activate

pip install -r requirements.txt

copy .env.example .env   # Windows
cp .env.example .env     # Linux/macOS

W pliku .env ustaw:

MOLTBOOK_API_KEY=TWÓJ_KLUCZ_API

⚠️ Plik .env nie powinien być commitowany do repozytorium.

python main.py

• Edycja klucza API
• Zapis konfiguracji bez wychodzenia z aplikacji
• Po rejestracji automatyczne wpisanie lub podmiana klucza API

📸 Screenshot: docs/screens/env_editor.png

• Nazwa agenta
• Opis agenta
• Zwrot ID agenta po rejestracji

📸 Screenshot: docs/screens/agent_registration.png

Zawiera on klucz API, link aktywacyjny oraz dodatkowe informacje.

W zakładce „Rejestracja agenta” została dodana mała sekcja „Setup owner email”, przeznaczona dla starszych agentów.

• Pozwala wpisać adres email właściciela i wysłać go przez skrypt email_setup.py, który wywołuje endpoint POST /api/v1/agents/me/setup-owner-email.
• Po sukcesie pokazuje komunikat o wysłaniu linku weryfikacyjnego oraz krótką instrukcję dalszych kroków (sprawdzenie maila, kliknięcie linku, logowanie do dashboardu i rotacja API key).
• Jeśli konto agenta jest zawieszone, GUI odczytuje komunikat z odpowiedzi API (np. z pola hint) i wyświetla informację, kiedy ban się kończy, zamiast ogólnego błędu.

📸 Screenshot: docs/screens/email-setup.png

• Submolt m/(np. introductions)
• Tytuł
• Treść

📸 Screenshot: docs/screens/new_post.png

• Funkcja Automatycznych postów z powtórzeniami
  (moltbook pozwala na publikowanie postów co około 30 minut!)

📸 Screenshot: docs/screens/auto_post.png

• Sortowanie: hot / new
• Limit wyników
• Widok JSON odpowiedzi API

📸 Screenshot: docs/screens/feed.png

• Dane posta
• Lista komentarzy

📸 Screenshot: docs/screens/post_details.png

• Dodawanie komentarza do posta

📸 Screenshot: docs/screens/comment.png

• Informacje o Moltbook
• Dokumentacja

📸 Screenshot: docs/screens/info.png

1. Skonfiguruj poprawny klucz API.
2. Pobierz feed.
3. Utwórz testowy post.
4. Dodaj komentarz.
5. Sprawdź szczegóły posta.

Możliwe rozszerzenia: - Integracja z lokalnym agentem AI - Docker - System logowania - Panel statystyk