Generator Kolorowanek AI

Aplikacja Streamlit do generowania czarno-białych kolorowanek dla dzieci z wykorzystaniem modeli OpenAI (DALL-E 3 oraz GPT-4o).

---

Opis projektu

Ten projekt umożliwia każdemu użytkownikowi szybkie tworzenie oryginalnych kolorowanek na podstawie własnego pomysłu. Wystarczy podać temat i krótki opis sceny, a aplikacja:

• opcjonalnie ulepszy opis za pomocą GPT-4o (bez kolorów, dźwięków, zapachów),
• wygeneruje prompt i przekaże go do DALL-E 3,
• stworzy czarno-biały rysunek do kolorowania (line art, 1024x1024),
• osadzi rysunek na białym tle A4 (poziomo, PDF, bez marginesów),
• umożliwi pobranie gotowej kolorowanki w formacie PDF.

Najważniejsze cechy

• Czysto czarno-białe rysunki – bez cieni, szarości, kolorów, wypełnień i marginesów.
• Prosty, funkcjonalny interfejs – tylko to, co potrzebne do generowania i pobierania kolorowanek.
• Ulepszanie opisu przez AI – jedno kliknięcie i Twój pomysł staje się bardziej szczegółowy, ale bez zbędnych kolorów, dźwięków i zapachów.
• Plik PDF gotowy do druku – idealny do domowego użytku, zajęć edukacyjnych lub prezentu.

Jak uruchomić?

Możesz skorzystać z aplikacji na dwa sposoby:

1. Bezpośrednio online:

   • Kliknij i uruchom bez instalacji: pokolorujmnie.streamlit.app

2. Lokalnie z repozytorium:

   • Sklonuj repozytorium:

     git clone https://github.com/AlanSteinbarth/Kolorowanki.git
     cd Kolorowanki

   • Zainstaluj wymagane biblioteki:

     pip install -r requirements.txt

   • Utwórz plik .env i dodaj swój klucz API OpenAI:

     OPENAI_API_KEY=sk-...

   • Uruchom aplikację:

     streamlit run app.py

Bezpieczeństwo

• Twój klucz API OpenAI nie jest nigdzie zapisywany ani przechowywany przez aplikację – jest używany wyłącznie w bieżącej sesji do komunikacji z API OpenAI.
• Aplikacja nie przesyła, nie loguje i nie udostępnia klucza osobom trzecim.
• Pamięć podręczna Streamlit (stan sesji) jest czyszczona po zamknięciu przeglądarki lub odświeżeniu aplikacji.
• Zalecamy nie udostępniać swojego klucza API innym osobom i nie commitować pliku .env do repozytorium.

Wkład i licencja

Projekt na licencji MIT. Chcesz zgłosić błąd lub dodać funkcję? Zajrzyj do pliku CONTRIBUTING.md!

Zrzuty ekranu

Początkowy widok aplikacji – puste pola do wpisania tematu i opisu kolorowanki.

Panel boczny z polem na klucz API oraz komunikat o poprawnym kluczu.

Przykład wpisanego tematu i prostego opisu kolorowanki.

Przykład ulepszonego opisu przez AI na podstawie prostego opisu użytkownika.

Wygenerowana kolorowanka (samochody wyścigowe) – podgląd i pobieranie PDF.

Finalna kolorowanka zapisana do pliku PDF.

Portfolio

Ten projekt powstał dla moich dzieci, które bardzo nudziły się podczas deszczu. Prosiły, abym wydrukował im jakąś kolorowankę z internetu, a ja nie mogłem znaleść zadnej fajnej. Dodatkowo, projekt jest częścią mojego portfolio programistycznego. Pokazuje praktyczne wykorzystanie AI, integrację z API, obsługę PDF oraz projektowanie prostych, użytecznych interfejsów w Pythonie.

Zachęcam do kontaktu i współpracy!

---

Autor: Alan Steinbarth