Documentation index

The TUI includes a Snapshot feature that captures:

  • Configuration
  • Model parameters
  • Replay memory state
  • Event log
  • Performance metrics

Snapshots are saved to a AI-Hydra directory that the system creates in the user’s home directory.

Example Report

πŸ“Έ AI Hydra - Snapshot Report
════════════════════════════
Timestamp              : 2026-04-05 12:00:13
Simulation Run Time    : 1h 17m
Current Episode Number : 5449
AI Hydra Version       : v0.25.2
Random Seed            : 1970

🎯 Epsilon Greedy
════════════════
Initial Epsilon    : 0.999
Minimum Epsilon    : 0.0
Epsilon Decay Rate : 0.98

🧠 GRU Model
═══════════
Input Size            : 23
Hidden Size           : 224
Dropout Layer P-Value : 0.1
Layers                : 3
Learning Rate         : 0.0005
Discount/Gamma        : 0.97
Tau                   : 0.001

πŸ’° Rewards
═════════
Food Reward          : 10.0
Collision Penalty    : -10.0
Max Moves Penalty    : 0.0
Empty Move Reward    : 0.0
Closer to Food       : 0.0
Further from Food    : 0.0
Max Moves Multiplier : 150

πŸ’Ύ Replay Memory
═══════════════
Max Frames                  : 125000
Memory Buckets              : 20
Max Training Frames         : 512
Highest Gear                : 26
Cooldown Threshold          : 100
Upshift Threshold           : 150
Downshift Threshold         : 50
Stagnant Threshold          : 300
Critical Stagnant Threshold : 500

🎲 Monte Carlo Tree Search
═════════════════════════
Gating P-Value      : 0.005
Search Depth        : 10
Iterations          : 100
Exploration P-Value : 0.9
Score Threshold     : 40
Steps               : 20

πŸ“š Event Log Messages
════════════════════
    -           0s    πŸ’» Hydra Client    πŸ”΅ Initialized...
    -           0s    ⚑ Simulation      πŸ”΅ Connected to simulation server
    -           0s    ⚑ Simulation      πŸ”΅ Simulation started
    100          24s    🏁 ATH Gearbox     🟒 Shifting UP: 1 > 2 - 6/85
    201       1m  2s    🏁 ATH Gearbox     🟒 Shifting UP: 2 > 3 - 8/64
    302       2m  0s    🏁 ATH Gearbox     🟒 Shifting UP: 3 > 4 - 10/51
    342       2m 26s    🧭 Epsilon         πŸ”΅ Exploration complete: Ξ΅ = 0.0
    403       3m 24s    🏁 ATH Gearbox     🟒 Shifting UP: 4 > 5 - 12/42
    420       3m 39s    πŸ’Ύ ATH Data Mgr    πŸ”΅ Memory is full (125000), pruning initiated
    504       5m  4s    🏁 ATH Gearbox     🟒 Shifting UP: 5 > 6 - 14/36
    604       6m 44s    🏁 ATH Gearbox     🟒 Shifting UP: 6 > 7 - 16/32
    656       7m 44s    πŸ’ͺ Train Manager   🟑 Stagnation alert raised
    656       7m 44s    πŸ™‚ Nice Policy     πŸ”΅ Enabling EpsilonNice
    706       8m 34s    🏁 ATH Gearbox     🟒 Shifting UP: 7 > 8 - 18/28
    807      10m 16s    🏁 ATH Gearbox     🟒 Shifting UP: 8 > 9 - 20/25
    856      11m  6s    πŸ’ͺ Train Manager   πŸ”΄ Critical stagnation alert(1). New threshold set: 1000
    856      11m  6s    🏁 ATH Gearbox     πŸ”΄ Critical Stagnation alert(1): Radical DOWN shift: 9 > 1 - 4/128
    884      11m 33s    πŸ’ͺ Train Manager   πŸ”΅ Stagnation alert cleared (new highscore: 14)
    884      11m 33s    πŸ™‚ Nice Policy     πŸ”΅ Disabling EpsilonNice
    956      12m 56s    🏁 ATH Gearbox     🟒 Shifting UP: 1 > 2 - 6/85
    1057      14m 54s    🏁 ATH Gearbox     🟒 Shifting UP: 2 > 3 - 8/64
    1158      16m 38s    🏁 ATH Gearbox     🟒 Shifting UP: 3 > 4 - 10/51
    1259      18m 25s    🏁 ATH Gearbox     🟒 Shifting UP: 4 > 5 - 12/42
    1261      18m 26s    πŸ’ͺ Train Manager   🟑 Stagnation alert raised
    1261      18m 26s    πŸ™‚ Nice Policy     πŸ”΅ Enabling EpsilonNice
    1360      20m  7s    🏁 ATH Gearbox     🟒 Shifting UP: 5 > 6 - 14/36
    1461      21m 39s    🏁 ATH Gearbox     🟒 Shifting UP: 6 > 7 - 16/32
    1562      23m  8s    🏁 ATH Gearbox     🟒 Shifting UP: 7 > 8 - 18/28
    1662      24m 54s    🏁 ATH Gearbox     🟒 Shifting UP: 8 > 9 - 20/25
    1764      26m 29s    🏁 ATH Gearbox     🟒 Shifting UP: 9 > 10 - 22/23
    1865      28m  4s    🏁 ATH Gearbox     🟒 Shifting UP: 10 > 11 - 24/21
    1911      28m 49s    πŸ’ͺ Train Manager   πŸ”΅ Stagnation alert cleared (new highscore: 18)
    1911      28m 49s    πŸ™‚ Nice Policy     πŸ”΅ Disabling EpsilonNice
    1966      29m 57s    🏁 ATH Gearbox     🟒 Shifting UP: 11 > 12 - 26/19
    2067      31m 57s    🏁 ATH Gearbox     🟒 Shifting UP: 12 > 13 - 28/18
    2168      33m 57s    🏁 ATH Gearbox     🟒 Shifting UP: 13 > 14 - 30/17


πŸ† Highscore Events
══════════════════
Epoch  Highscore  Time     Epsilon
═════  ═════════  ═══════  ═══════
0      0          0s       0.9900
1      1          0s       0.9990
93     2          21s      0.1557
118    3          30s      0.0921
218    4           1m 11s  0.0122
218    5           1m 11s  0.0122
326    6           2m 14s  0.0014
326    7           2m 14s  0.0014
353    8           2m 36s  0.0000
353    9           2m 36s  0.0000
353    10          2m 36s  0.0000
356    11          2m 38s  0.0000
356    12          2m 38s  0.0000
356    13          2m 38s  0.0000
884    14         11m 33s  0.0000
961    15         13m  2s  0.0000
961    16         13m  2s  0.0000
961    17         13m  2s  0.0000
1911   18         28m 49s  0.0000
1914   19         28m 53s  0.0000
1914   20         28m 53s  0.0000
1914   21         28m 53s  0.0000
1914   22         28m 53s  0.0000
1914   23         28m 53s  0.0000
1914   24         28m 53s  0.0000
1914   25         28m 53s  0.0000
1914   26         28m 53s  0.0000


πŸ™‚ Epsilon Nice
══════════════
P-Value    : 0.005
Nice Steps : 20

πŸ™‚ Epsilon Nice Events
═════════════════════
Window     Epoch  Calls  Triggered  Fatal Suggested  Overrides  No Safe Alt  Trigger Rate  Override Rate
═════════  ═════  ═════  ═════════  ═══════════════  ═════════  ═══════════  ════════════  ═════════════
1-100      100    0      0          0                0          0            0.0000        0.0000
101-200    200    0      0          0                0          0            0.0000        0.0000
201-300    300    0      0          0                0          0            0.0000        0.0000
301-400    400    0      0          0                0          0            0.0000        0.0000
401-500    500    0      0          0                0          0            0.0000        0.0000
501-600    600    0      0          0                0          0            0.0000        0.0000
601-700    700    27186  2480       1                2353       127          0.0912        0.0866
701-800    800    63755  5620       7                5397       223          0.0882        0.0847
801-900    900    54906  5360       6                5131       229          0.0976        0.0935
901-1000   1000   0      0          0                0          0            0.0000        0.0000
1001-1100  1100   0      0          0                0          0            0.0000        0.0000
1101-1200  1200   0      0          0                0          0            0.0000        0.0000
1201-1300  1300   22060  1840       4                1774       66           0.0834        0.0804
1301-1400  1400   64134  5900       2                5630       270          0.0920        0.0878
1401-1500  1500   52335  4800       2                4612       188          0.0917        0.0881
1501-1600  1600   63740  5860       0                5591       269          0.0919        0.0877
1601-1700  1700   64478  5660       0                5362       298          0.0878        0.0832
1701-1800  1800   62157  5540       1                5248       292          0.0891        0.0844
1801-1900  1900   60779  5211       1                4919       292          0.0857        0.0809
1901-2000  2000   5620   609        0                587        22           0.1084        0.1044
2001-2100  2100   0      0          0                0          0            0.0000        0.0000
2101-2200  2200   0      0          0                0          0            0.0000        0.0000


🎲 Monte Carlo Tree Search Events
════════════════════════════════
Window     Calls  Triggered  Trigger Rate
═════════  ═════  ═════════  ════════════
1-100      11492  0          0.0000
101-200    17179  0          0.0000
201-300    31776  0          0.0000
301-400    51512  0          0.0000
401-500    68785  0          0.0000
501-600    66006  0          0.0000
601-700    73588  0          0.0000
701-800    63755  0          0.0000
801-900    68050  0          0.0000
901-1000   83468  0          0.0000
1001-1100  70904  0          0.0000
1101-1200  66845  0          0.0000
1201-1300  66127  0          0.0000
1301-1400  64134  0          0.0000
1401-1500  52335  0          0.0000
1501-1600  63740  0          0.0000
1601-1700  64478  0          0.0000
1701-1800  62157  0          0.0000
1801-1900  60779  0          0.0000
1901-2000  75966  0          0.0000
2001-2100  81013  0          0.0000
2101-2200  86708  0          0.0000


βš™οΈ  ATH Shift / Mean / Median
═════════════════════════════
Epoch  Gear  Seq Length  Batch Size  Mean  Median  Recent Mean  Recent Median
═════  ════  ══════════  ══════════  ════  ══════  ═══════════  ═════════════
100    2     6           85          0.30  0.00    0.30         0.00
200    2     6           85          0.55  0.00    0.55         0.00
300    3     8           64          0.91  1.00    0.91         1.00
400    4     10          51          1.59  1.00    1.59         1.00
500    5     12          42          2.12  1.00    2.12         1.00
600    6     14          36          2.51  2.00    2.95         3.00
700    7     16          32          2.80  3.00    3.70         4.00
800    8     18          28          2.99  3.00    4.24         5.00
900    1     4           128         3.23  3.00    4.53         5.00
1000   2     6           85          3.42  3.00    4.73         5.00
1100   3     8           64          3.48  3.00    4.64         5.00
1200   4     10          51          3.50  3.00    4.49         5.00
1300   5     12          42          3.58  3.00    4.54         5.00
1400   6     14          36          3.66  4.00    4.44         5.00
1500   7     16          32          3.73  4.00    4.34         4.00
1600   8     18          28          3.83  4.00    4.61         5.00
1700   9     20          25          3.90  4.00    4.85         5.00
1800   10    22          23          3.98  4.00    5.00         5.00
1900   11    24          21          4.11  4.00    5.37         5.00
2000   12    26          19          4.33  5.00    6.13         6.00
2100   13    28          18          4.54  5.00    6.82         7.00
2200   14    30          17          4.67  5.00    7.31         7.00


πŸͺ£ ATH Memory Bucket Usage
═════════════════════════
Epoch  Gear  b2   b3   b4   b5   b6   b7   b8   b9   b10  b11  b12  b13  b14  b15  b16  b17  b18  b19  b20  b21
═════  ════  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══  ═══
100    2     108  108  107  106  100  92   82   74   69   67   64   61   57   54   53   48   47   40   34   32
200    3     208  206  203  188  172  157  145  140  132  119  115  107  103  95   88   85   79   74   71   68
300    4     308  304  296  270  246  235  219  200  191  182  169  160  152  145  141  136  132  120  115  108
400    5     406  403  381  350  334  316  297  283  267  257  247  237  231  227  212  200  194  185  177  172
500    6     202  202  201  201  201  201  200  196  195  191  191  189  185  182  179  178  176  174  170  167
600    7     183  183  183  181  181  179  177  174  173  171  169  168  165  162  160  159  155  149  143  141
700    8     178  178  177  176  174  173  170  167  165  162  162  157  153  152  148  144  140  139  134  133
800    9     186  186  186  186  184  182  178  175  174  174  170  170  168  167  167  163  157  154  152  148
900    1     189  189  189  189  189  189  189  189  189  188  188  188  188  188  188  188  188  188  188  188
1000   2     156  156  156  156  156  156  156  156  156  156  156  156  156  156  156  156  156  156  156  156
1100   3     163  163  163  163  163  163  162  162  161  161  161  161  161  161  160  160  160  159  159  159
1200   4     179  179  179  178  178  178  177  177  177  176  176  173  172  172  171  171  169  168  168  164
1300   5     182  182  181  180  180  178  178  177  176  175  173  172  169  168  166  166  162  161  159  158
1400   6     192  192  191  191  190  190  188  183  181  180  178  175  174  173  170  168  166  164  162  161
1500   7     214  214  214  214  214  211  205  203  201  199  195  194  187  184  180  176  173  166  158  157
1600   8     211  211  211  211  209  206  205  204  202  200  196  191  187  182  177  170  164  159  151  147
1700   9     190  190  190  188  188  188  188  185  184  183  180  175  170  168  164  158  149  147  145  144
1800   10    202  202  201  200  198  196  194  192  189  184  179  176  172  167  160  154  152  147  142  135
1900   11    204  202  201  201  198  194  194  192  186  181  180  177  168  166  163  160  151  144  119  116
2000   12    172  170  169  169  167  165  163  160  157  155  153  148  142  140  139  134  129  114  111  108
2100   13    158  157  156  155  153  152  152  150  148  143  140  132  130  130  126  124  108  105  101  98
2200   14    148  148  148  147  145  145  143  139  139  135  132  127  123  120  117  110  105  102  98   96