Nowoczesne środowisko AI z pełnym desktopem Ubuntu w przeglądarce

🎯 Split-Screen Interface - AI chat + VNC desktop w jednym oknie
🖥️ Ubuntu Desktop - Pełne środowisko programistyczne w przeglądarce
🤖 AI Assistant - Integracja z Google Gemini AI
🐳 Docker Ready - Jeden klick do uruchomienia
🎨 Modern UI - Dark theme, resizable panels
🔧 Dev Tools - VS Code, Firefox, Terminal preinstalowane

# 1. Sklonuj projekt
git clone <repository>
cd ttki-ai-desktop

# 2. Skonfiguruj API key
cp .env.example .env
nano .env  # Dodaj GEMINI_API_KEY

# 3. Uruchom system
./start_ttki.sh

🌟 Gotowe! Otwórz http://localhost:4001

pip install -r requirements.txt

sudo apt update sudo apt install tigervnc-standalone-server tigervnc-viewer

vncpasswd

cp .env.example .env

nano .env

export GEMINI_API_KEY="your_actual_api_key_here" export FLASK_SECRET_KEY="your_secure_secret_key_here"

⚠️ **UWAGA BEZPIECZEŃSTWA**: Nigdy nie commituj pliku `.env` do git! Zawiera on prywatne klucze API.

# Uruchomienie wszystkich usług
./ttki.sh start

# Sprawdzenie statusu
./ttki.sh status

# Zatrzymanie usług
./ttki.sh stop

Po uruchomieniu dostępne są następujące adresy:

• 🏠 Główny portal: http://localhost:4000
• 🤖 AI Terminal: http://localhost:4001
• 🖥️ VNC Desktop: http://localhost:4051

• config/prompt.txt - Systemowy prompt dla AI
• config/functions.txt - Definicje funkcji AI
• config/ports.conf - Konfiguracja portów

# Google Gemini AI (WYMAGANE)
export GEMINI_API_KEY="your_actual_gemini_api_key_here"

# Flask Security (WYMAGANE dla produkcji)
export FLASK_SECRET_KEY="your_secure_random_secret_key_here"

⚠️ BEZPIECZEŃSTWO: Użyj .env pliku dla zmiennych środowiskowych zamiast exportu w terminalu!

ttki-cli/
├── src/           # Kod źródłowy aplikacji
├── scripts/       # Skrypty zarządzające
├── config/        # Pliki konfiguracyjne
├── tests/         # Testy automatyczne
├── docs/          # Dokumentacja
├── templates/     # Szablony HTML
├── logs/          # Pliki logów
└── backup/        # Kopie zapasowe

# Podstawowe operacje
./ttki.sh start     # Uruchom wszystkie usługi
./ttki.sh stop      # Zatrzymaj wszystkie usługi
./ttki.sh restart   # Restart usług
./ttki.sh status    # Pokaż status usług

# Diagnostyka
./ttki.sh ports     # Sprawdź porty
./ttki.sh logs      # Pokaż logi aplikacji
./ttki.sh clean     # Wyczyść procesy

# Bezpieczeństwo
./scripts/secure_ttki.sh  # Zabezpiecz pliki config

# Uruchomienie testów
python -m pytest tests/

# Testy konkretnego modułu
python -m pytest tests/test_flask.py

# Testy środowiska
python tests/test_environment.py

• src/app.py - Główna aplikacja Flask
• src/user.py - Zarządzanie użytkownikami
• scripts/ttki.sh - Główny skrypt zarządzający
• scripts/status_ttki.sh - Monitoring statusu

1. Edytuj config/functions.txt
2. Dodaj implementację w src/app.py
3. Zaktualizuj TOOL_FUNCTIONS mapping
4. Przetestuj funkcjonalność

• 📖 Przewodnik instalacji
• 🏗️ Architektura systemu
• 🔧 Integracja Gemini
• 🧪 Testowanie

Zapraszamy do współpracy! Aby dodać funkcjonalność:

1. Fork repozytorium
2. Utwórz branch funkcji (git checkout -b feature/AmazingFeature)
3. Commit zmian (git commit -m 'Add some AmazingFeature')
4. Push do brancha (git push origin feature/AmazingFeature)
5. Otwórz Pull Request

Jeśli napotkasz problemy:

1. Sprawdź Issues
2. Uruchom ./ttki.sh status dla diagnostyki
3. Sprawdź logi: ./ttki.sh logs
4. Utwórz nowy Issue z opisem problemu

flask>=2.0.0
flask-socketio>=5.0.0
google-generativeai>=0.3.0

tigervnc-standalone-server
tigervnc-viewer
python3-websockify

• ✅ Reorganizacja struktury projektu na profesjonalną
• ✅ Zmiana nazw plików konfiguracyjnych (prompt.txt, functions.txt)
• ✅ Refaktoryzacja nazw funkcji AI
• ✅ Dodanie README.md i licencji MIT
• ✅ Utworzenie requirements.txt
• ✅ Usprawnienie skryptów zarządzających

• ✅ Pierwsza wersja robocza
• ✅ AI Terminal z Google Gemini
• ✅ VNC Desktop integration
• ✅ Podstawowe skrypty zarządzające

Ten projekt jest licencjonowany na licencji MIT - szczegóły w pliku LICENSE.

Copyright (c) 2025 TTKi-cli Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

TTKi - Initial work

• Google Gemini AI za potężne API
• noVNC team za excellent web VNC client
• TigerVNC za reliable VNC server
• Flask community za amazing web framework

• GitHub: @yourusername
• Email: [email protected]

⭐ Jeśli projekt Ci się podoba, zostaw gwiazdkę! ⭐