https://github.com/py-lama/git2blog
Generator bloga z historii Git używający lokalnego modelu Ollama LLM.
https://github.com/py-lama/git2blog
chat commit git git2blog git2post llm ollama post wordpress
Last synced: 4 months ago
JSON representation
Generator bloga z historii Git używający lokalnego modelu Ollama LLM.
- Host: GitHub
- URL: https://github.com/py-lama/git2blog
- Owner: py-lama
- License: apache-2.0
- Created: 2025-05-28T11:09:58.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-28T14:44:36.000Z (about 1 year ago)
- Last Synced: 2025-11-28T00:14:02.209Z (7 months ago)
- Topics: chat, commit, git, git2blog, git2post, llm, ollama, post, wordpress
- Language: HTML
- Homepage: https://py-lama.github.io/git2blog/
- Size: 91.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# git2blog
Generator bloga z historii Git używający lokalnego modelu Ollama LLM.
## Funkcje
- **AI-powered**: Używa Ollama do generowania interesujących postów z commitów Git
- **Automatyczna konwersja**: Przekształca suche commity w angażujące posty blogowe
- **Gotowe szablony**: Generuje kompletny blog HTML gotowy do publikacji
- **Konfigurowalne**: Pełna personalizacja przez plik YAML
- **Inteligentne filtrowanie**: Pomija merge commity i spam
- **Polski interface**: Wszystko po polsku
## Wymagania
1. **Python 3.7+**
2. **Git** - repozytorium z historią commitów
3. **Ollama** - lokalny serwer LLM
```bash
# Instalacja Ollama (Linux/macOS)
curl -fsSL https://ollama.ai/install.sh | sh
# Uruchom model (np. llama3.2)
ollama run llama3.2
```
## Szybki start
1. Zainstaluj zależności:
```bash
pip install -r requirements.txt
```
2. (Opcjonalnie) Zainstaluj narzędzia deweloperskie:
```bash
make install-dev
```
3. Skonfiguruj projekt:
```bash
python git2blog.py init
# lub przez menu:
python git2blog.py menu
```
4. Wygeneruj bloga:
```bash
python git2blog.py run
# lub przez Makefile:
make run
```
## Instalacja
1. **Sklonuj/pobierz projekt**:
```bash
mkdir git2blog && cd git2blog
# Skopiuj git2blog.py do tego katalogu
```
2. **Zainstaluj zależności**:
```bash
pip install -r requirements.txt
```
3. **Utwórz konfigurację**:
```bash
python git2blog.py --init
```
## Użycie
1. **Przejdź do swojego repozytorium Git**:
```bash
cd /ścieżka/do/twojego/projektu
```
2. **Uruchom generator**:
```bash
python /ścieżka/do/git2blog.py
```
3. **Otwórz wygenerowany blog**:
```bash
open blog/index.html
```
## Testowanie
Aby uruchomić testy:
```bash
make test
# lub bezpośrednio:
pytest
```
## Najważniejsze cele Makefile
- `make install` – instalacja zależności
- `make install-dev` – instalacja narzędzi deweloperskich
- `make run` – generowanie bloga
- `make test` – uruchomienie testów
- `make clean` – usunięcie plików tymczasowych
## Konfiguracja
Edytuj `git2blog.yaml` aby dostosować:
```yaml
# Ollama settings
ollama_url: 'http://localhost:11434'
model: 'llama3.2' # lub codellama, mistral, itp.
timeout: 120 # (opcjonalnie) czas oczekiwania na odpowiedź Ollama w sekundach
# Blog settings
blog_title: 'Mój Blog Projektowy'
blog_description: 'Blog generowany automatycznie z historii Git'
author: 'Twoje Imię'
output_dir: 'blog'
# Linki do projektu (opcjonalnie)
repo_url: 'https://github.com/uzytkownik/projekt' # link do repozytorium (GitHub/GitLab)
issues_url: 'https://github.com/uzytkownik/projekt/issues' # link do issues (opcjonalnie)
pages_url: 'https://uzytkownik.github.io/projekt' # link do GitHub Pages/GitLab Pages (opcjonalnie)
# Generation settings
commit_limit: 50 # Ile commitów przetworzyć
posts_per_page: 10 # Posty na stronę (przyszła funkcja)
ignore_merge_commits: true # Pomijaj merge commity
```
## Nowości
- Domyślny timeout zapytań do Ollama został zwiększony do **120 sekund** (wcześniej 30s). Jeśli generacja posta trwa dłużej, nie przerywaj procesu od razu – większe modele mogą potrzebować więcej czasu.
- Dodano obsługę linków do profilu autora (GitHub/GitLab), historii commitów (po dacie), commita, repozytorium, issues i GitHub Pages/GitLab Pages w wygenerowanych stronach HTML (na podstawie konfiguracji repo_url/issues_url/pages_url).
## Przykładowe użycie
```bash
# W katalogu z twoim projektem Git
cd ~/moje-projekty/awesome-app
# Wygeneruj blog (domyślna konfiguracja)
python ~/git2blog/git2blog.py
# Użyj własnej konfiguracji
python ~/git2blog/git2blog.py --config custom-config.yaml
# Blog zostanie utworzony w katalogu ./blog/
ls blog/
# index.html post_1.html post_2.html ...
```
## Struktura wyjściowa
```
blog/
├── index.html # Strona główna z listą postów
├── post_1.html # Najnowszy commit jako post
├── post_2.html # Drugi commit
└── ...
```
## Dostępne modele Ollama
Popularne modele do wyboru:
- `llama3.2` - Szybki i dobry (domyślny)
- `codellama` - Specjalizuje się w kodzie
- `mistral` - Mały i efektywny
- `gemma` - Od Google
Zmień model w `git2blog.yaml`:
```yaml
model: 'codellama'
```
## Troubleshooting
### "Nie można połączyć się z Ollama"
```bash
# Sprawdź czy Ollama działa
curl http://localhost:11434/api/tags
# Jeśli nie, uruchom:
ollama serve
```
### "Nie znajdujesz się w repozytorium Git"
```bash
# Upewnij się że jesteś w katalogu z .git
ls -la | grep .git
```
### "Nie znaleziono żadnych commitów"
```bash
# Sprawdź historię Git
git log --oneline -10
```
### "Timeout podczas generowania posta lub długi czas oczekiwania"
Zwiększono domyślny timeout do 120 sekund. Jeśli nadal pojawia się timeout, sprawdź czy Twój model Ollama nie wymaga jeszcze więcej czasu lub zasobów.
Możesz też ustawić własny timeout (w pliku konfiguracyjnym lub przez zmienną środowiskową, jeśli obsługiwane):
```yaml
timeout: 180
```
lub:
```bash
export OLLAMA_TIMEOUT=180
```
## Planowane funkcje
- [ ] Obsługa markdown zamiast HTML
- [ ] Paginacja dla dużych blogów
- [ ] Kategorie i tagi na podstawie ścieżek plików
- [ ] RSS feed
- [ ] Ciemny motyw
- [ ] Export do platform blogowych
## Licencja
Licencja: [Apache 2.0](LICENSE)
## Autor
Tom Sapletta — DevOps Engineer & Systems Architect