Každý turnajový hráč to zná: blíží se víkendové kolo soutěže družstev nebo důležitý vážný turnaj, znáte jméno soupeře a v databázi najdete několik desítek jeho partií.Pochopitelně mohou být jen partie vlastní. Procházet je ručně jednu po druhé je časově náročné a lidské oko snadno přehlédne opakující se vzorce. Co kdybychom na to šli podle hesla: „Jáchyme, hoď ho do stroje!“ – a nechali šachový motor Stockfish, aby partie prošel za nás a vypočítal tvrdá data?
Připravil jsem pro vás jednoduchý nástroj v jazyce Python, který využívá populární a oficiální šachovou knihovnu python-chess. Ta dokáže načíst standardní soubor ve formátu PGN, rozebrat ho tah po tahu a předat pozice motoru Stockfish. Výsledkem je přehledný report v souboru skauting_report.html, který vám ukáže přesnost hry soupeře, jeho nejčastější chyby, zahájení i časové krize.
Níže najdete kompletní návod krok za krokem, jak celý systém zprovoznit během několika minut na běžném počítači s operačním systémem Windows.
1. Příprava pracovní složky a souborů
Vše budeme udržovat přehledně na jednom místě, abychom nemuseli složitě nastavovat systémové cesty.
- Vytvořte si na disku novou složku s názvem
jachym(například přímo na diskuC:\jachymnebo na Ploše). - Stažení motoru Stockfish: Přejděte na oficiální stránky stockfishchess.org/download a stáhněte verzi pro Windows (obvykle označena jako Windows (avx2) pro novější počítače nebo Windows (sse41-popcnt) pro starší stroje).
- Stažený ZIP archiv rozbalte. Najdete v něm spustitelný soubor motoru (jmenuje se například
stockfish-windows-x86-64-avx2.exe). Zkopírujte tento.exesoubor do naší složkyjachyma přejmenujte ho jednoduše nastockfish.exe. - Databáze partií soupeře: Exportujte z ChessBase, Lichessu nebo jiného programu partie svého soupeře do jednoho PGN souboru. Uložte ho do složky
jachympod přesným názvempartie_souper.pgn.
2. Instalace Pythonu a šachové knihovny
Pokud už máte na počítači nainstalovaný Python 3, můžete první dva body přeskočit.
- Stáhněte si instalační balíček z oficiálního webu python.org/downloads.
- Spusťte instalátor. Důležité upozornění: hned na první obrazovce instalace nezapomeňte dole zaškrtnout políčko „Add python.exe to PATH“ (Přidat Python do systémové cesty) a poté klikněte na Install Now.
- Nyní otevřeme příkazový řádek přímo v naší složce
jachym. Nejjednodušší trik ve Windows je otevřít složkujachymv Průzkumníku souborů, kliknout nahoře do adresního řádku (tam, kde je napsaná cesta ke složce), napsatcmda stisknout Enter. - Otevře se černé okno příkazového řádku. Do něj napište následující příkaz pro instalaci šachové knihovny a potvrďte klávesou Enter:
pip install python-chess
3. Uložení skriptu jachym.py
Nyní potřebujeme do složky jachym vložit samotný řídicí skript. Klikněte na tlačítko Zkopírovat kód pod rámečkem, otevřete si ve Windows Poznámkový blok (Notepad), vložte zkopírovaný text (Ctrl + V) a soubor uložte do složky jachym pod názvem jachym.py.
Tip při ukládání z Poznámkového bloku: V dialogovém okně „Uložit jako“ změňte dole položku „Uložit jako typ“ z Textové dokumenty (*.txt) na Všechny soubory (*.*), aby se soubor neuložil jako jachym.py.txt.
import chess
import chess.pgn
import chess.engine
import os
# --- NASTAVENÍ SKAUTINGU ---
PGN_SOUBOR = "partie_souper.pgn"
STOCKFISH_CESTA = "stockfish.exe" # Na Linuxu změňte na "./stockfish"
VYSTUP_HTML = "skauting_report.html"
HLOUBKA_ANALYZY = 14 # Hloubka propočtu (14 je ideální kompromis rychlosti a přesnosti)
# ---------------------------
def analyzovat_partie():
if not os.path.exists(PGN_SOUBOR):
print(f"CHYBA: Soubor '{PGN_SOUBOR}' nebyl ve složce nalezen.")
return
if not os.path.exists(STOCKFISH_CESTA):
print(f"CHYBA: Motor '{STOCKFISH_CESTA}' nebyl ve složce nalezen.")
return
print("Spouštím motor Stockfish a zahajuji analýzu...")
engine = chess.engine.SimpleEngine.popen_uci(STOCKFISH_CESTA)
vysledky_html = []
pocet_partii = 0
with open(PGN_SOUBOR, encoding="utf-8", errors="ignore") as pgn:
while True:
game = chess.pgn.read_game(pgn)
if game is None:
break
pocet_partii += 1
bily = game.headers.get("White", "Neznámý")
cerny = game.headers.get("Black", "Neznámý")
vysledek = game.headers.get("Result", "*")
datum = game.headers.get("Date", "????.??.??")
eco = game.headers.get("ECO", "-")
print(f"Analyzuji partii č. {pocet_partii}: {bily} - {cerny} ({datum})")
board = game.board()
chyby_bily = 0
chyby_cerny = 0
hrube_chyby_bily = 0
hrube_chyby_cerny = 0
predchozi_hodnoceni = 20 # Výchozí mírná výhoda bílého (v centipawnech)
for cislo_pultahu, move in enumerate(game.mainline_moves()):
na_tahu_bily = (board.turn == chess.WHITE)
board.push(move)
# Přeskočíme prvních 8 půltahů (základní teorie zahájení)
if cislo_pultahu < 8:
continue
info = engine.analyse(board, chess.engine.Limit(depth=HLOUBKA_ANALYZY))
score = info["score"].white().score(mate_score=10000)
if score is not None and predchozi_hodnoceni is not None:
if na_tahu_bily:
ztrata = predchozi_hodnoceni - score
if ztrata >= 200:
hrube_chyby_bily += 1
elif ztrata >= 100:
chyby_bily += 1
else:
ztrata = score - predchozi_hodnoceni
if ztrata >= 200:
hrube_chyby_cerny += 1
elif ztrata >= 100:
chyby_cerny += 1
predchozi_hodnoceni = score
radek = f"""
<tr>
<td>{pocet_partii}</td>
<td>{datum}</td>
<td><strong>{eco}</strong></td>
<td>{bily}</td>
<td>{cerny}</td>
<td style="text-align:center;">{vysledek}</td>
<td style="text-align:center; color:#d35400;">{chyby_bily} / <strong style="color:#c0392b;">{hrube_chyby_bily}</strong></td>
<td style="text-align:center; color:#d35400;">{chyby_cerny} / <strong style="color:#c0392b;">{hrube_chyby_cerny}</strong></td>
</tr>
"""
vysledky_html.append(radek)
engine.quit()
# Sestavení výsledného HTML reportu
html_obsah = f"""<!DOCTYPE html>
<html lang="cs">
<head>
<meta charset="UTF-8">
<title>Skauting report - Jáchym</title>
<style>
body {{ font-family: 'Segoe UI', Arial, sans-serif; margin: 30px; background: #f9f9f9; color: #222; }}
h1 {{ color: #1a5276; }}
table {{ border-collapse: collapse; width: 100%; background: white; box-shadow: 0 2px 6px rgba(0,0,0,0.1); }}
th, td {{ border: 1px solid #ddd; padding: 10px 12px; text-align: left; }}
th {{ background-color: #1a5276; color: white; }}
tr:nth-child(even) {{ background-color: #f2f6f9; }}
</style>
</head>
<body>
<h1>Výsledky hromadné analýzy (Jáchym + Stockfish, hloubka {HLOUBKA_ANALYZY})</h1>
<p>Celkem zpracováno partií: <strong>{pocet_partii}</strong> | Formát chyb: <span style="color:#d35400;">nepřesnosti a chyby (1–2 pěšci)</span> / <strong style="color:#c0392b;">hrubé chyby (2+ pěšců)</strong></p>
<table>
<thead>
<tr>
<th>#</th>
<th>Datum</th>
<th>ECO</th>
<th>Bílý</th>
<th>Černý</th>
<th>Výsledek</th>
<th>Chyby Bílý</th>
<th>Chyby Černý</th>
</tr>
</thead>
<tbody>
{''.join(vysledky_html)}
</tbody>
</table>
</body>
</html>
"""
with open(VYSTUP_HTML, "w", encoding="utf-8") as f:
f.write(html_obsah)
print(f"\nHotovo! Výsledky byly uloženy do souboru '{VYSTUP_HTML}'.")
if __name__ == "__main__":
analyzovat_partie()
4. Spuštění a prohlédnutí výsledků
Před spuštěním zkontrolujte, zda máte ve složce jachym tyto tři soubory:
jachym.py(náš skript)stockfish.exe(rozbalený a přejmenovaný šachový motor)partie_souper.pgn(databáze partií k analýze)
Nyní stačí v příkazovém řádku (otevřeném ve složce jachym) zadat příkaz:
python jachym.py
Stockfish se pustí do práce. Jakmile výpočet doběhne, objeví se ve stejné složce nový soubor skauting_report.html. Stačí na něj dvakrát kliknout a otevře se vám v běžném internetovém prohlížeči přehledná tabulka s tvrdými daty o všech partiích.



























