TECHNICAL SPECIFICATION

Go Lab Feature Guide & Specification

All features and internal specifications of KataGo AI, plus UI/UX details, generated from Swift source code

Note: This page is a technical document generated by AI analyzing the app's Swift source code. Actual app specifications and behavior may differ in detail. Please be aware of this in advance.

Go Lab at a Glance: A One-Stop Experience from Play to Improvement

Go Lab is not just a Go app. The entire flow of "Play → End → Analyze → Review → Branch → Save" completes within a single app. No exporting to external tools, no switching to another app. The overview is shown below.

① Play → ② End & Dead Stones → ③ Analyze → ④ Review & Branch → ⑤ Save & Report
PhaseWhat You Can DoRelated Chapters
① Play CPU / Local / Online. Supports HumanSL modern and classic styles, Lv.1–63, handicap stones, and playing as White. Chapters 1–5
② End Two consecutive passes or resignation ends the game. Under Japanese rules, a dead stone marking phase follows, with AI-highlighted candidates. Chapter 1
③ Analyze Visualize position graph, candidate moves, territory, and thinking time. One-tap bad-move analysis (Score Drop / Winrate Drop). Chapters 6–8
④ Review & Branch Tap the board to branch. PV ghost playback, bulk apply, and variation tree for full overview. Chapter 7
⑤ Save & Report Game records saved as JSON locally. Reports shareable as image or PDF. SGF import/export supported. Chapter 8, Chapter 9
+ Learning Tsumego (streaks, multiple solutions) and lessons with a Live2D character (curriculum + interactive tests). Chapter 10, Chapter 11

How to read this page: Each chapter begins with "What You Can Do in This Chapter" (product introduction), followed by "Technical & Internal Specifications." Parts I–IV follow the product usage flow, and the final cross-cutting chapter covers design principles common to the whole app.

Part I: Play & Online Play

Chapter 1: Game Modes and Rule Settings

F-101 to F-107

What You Can Do in This Chapter: Play in three modes — CPU, local two-player, or online. Supports all combinations of Japanese, Chinese, and Korean rules with 9×9, 13×13, and 19×19 boards. Handicap stones and playing as White are also supported, and after the game ends, the AI automatically highlights dead stone candidates.

1.1 Game Modes

ModeOverviewNetwork
CPU GamePlay against the KataGo engine. Choose difficulty, model, and side.Not required
Local Two-PlayerTwo players alternate on a single device.Not required
Online PlayMatched via the app's own server. Rating changes apply (Chapter 4).Required

1.2 Rule Sets and Komi

RulesScoringKomiNotes
JapaneseTerritory + Captures6.5Traditional Japanese method.
ChineseArea (Stones + Territory)7.5Chinese method. Higher komi.
KoreanTerritory + Captures6.5Similar to Japanese rules.

1.3 Board Size × Rule Combinations

Board SizeJapaneseChineseKorean
9×9◯◯◯
13×13◯◯◯
19×19◯◯◯

All board sizes × all rules are supported.

1.4 Handicap Stones and Side Selection

1.5 Game End and Dead Stone Judgment

Two consecutive passes or resignation ends the game. Under Japanese/Korean rules (territory + captures), a dead stone marking phase follows the game end.

1.6 Post-Game Actions

— 01 —

Chapter 2: CPU Difficulty Control (Lv.1–63)

F-108

What You Can Do in This Chapter: Select CPU strength from 63 levels, Lv.1 to Lv.63. From beginner to pro-level, you can find an opponent at your level.

2.1 Difficulty and Internal Parameters

Difficulty is not a simple increase or decrease in Visits; it's implemented by adding intentional noise (randomness or mistakes) to KataGo's inference results.

2.2 Level Band Trends

Level BandApproximate StrengthInternal Behavior
Lv.1–Lv.10Beginner–NoviceHigh Random Rate and Mistake Rate; plays bad moves intentionally.
Lv.11–Lv.25IntermediateMistake rate decreases. Visits gradually increase.
Lv.26–Lv.40AdvancedAlmost no mistakes; deeper search.
Lv.41–Lv.63Dan–Pro levelNo weakening. Close to KataGo's pure inference results.
— 02 —

Chapter 3: HumanSL (Human-like AI)

F-109, F-110

What You Can Do in This Chapter: Use AI that chooses moves "likely to be played by a human of a specified rank" rather than "best moves." Choose between modern and classic styles, with separate strengths configurable for play and analysis.

3.1 Technical Characteristics of HumanSL

3.2 Two Profile Systems: Modern and Classic

SystemPrefixCharacteristicsBest For
Modern Style rank_20k – rank_9d Learned from modern human players' records. Reproduces the rational move sense of the AI era. Practicing with "human-like moves of today"
Classic Style preaz_20k – preaz_9d Learned from pre-AlphaGo human records. Greater freedom in the opening, with a traditional style. Experiencing "human-like moves before AI," or enjoying the feel of classical Go literature

3.3 Separation of Play and Analysis Models

In Go Lab, you can set the play model and the analysis model separately, along with HumanSL profiles for each.

Example setup: "Play against HumanSL 15-kyu (human-like moves)" and "Analyze with High model (b18c384nbt) for accuracy" — this combination is possible. Play a game against HumanSL, then review it with a high-accuracy model — a complete learning cycle.

Note that when HumanSL is selected as the play model, b6c96 (Light) cannot be selected for analysis (the accuracy gap is too large). For analysis, choose from b18c384 or HumanSL.

Note

HumanSL doesn't aim for "best moves," so the position graph tends to be less stable than with standard KataGo. For high-precision analysis, use the High model (b18c384nbt).

— 03 —

Chapter 4: Online Play

F-111

What You Can Do in This Chapter: Play in real time against players worldwide via the app's own server. Ratings change based on results, and you can compete for the top of the leaderboard.

4.1 Matching and Ratings

4.2 Game Flow

  1. Select "Online" on the game settings screen and start Quick Match.
  2. On match, a 3.5-second countdown starts.
  3. During the game, both players' moves are synchronized in real time.
  4. On game end (two consecutive passes or resignation), the winner and rating change are finalized.
— 04 —

Chapter 5: OGS Integration

F-112, F-113, F-114

What You Can Do in This Chapter: Integrate with OGS (Online Go Server), one of the largest online Go servers. Both spectating (Watch) and playing (Play) are supported, and spectated games can be saved as SGF for analysis.

5.1 OGS Watch

5.2 OGS Play

5.3 Time Control

SystemDescription
FischerAdded increment per move on top of initial time (e.g., 5 min + 7 sec).
ByoyomiAfter main time is used up, a fixed time is granted per move (e.g., 5 min + 5x30 sec).
CanadianComplete a specified number of moves within a time (e.g., 5 min + 10 moves in 5 min).

5.4 In-Game Operations and Clock Correction

5.5 Saving Spectated and Played Game Records

— 05 —

Part II: AI Analysis, Review & Game Records

Chapter 6: Real-time Analysis

F-201 to F-204, F-220-1

What You Can Do in This Chapter: View KataGo's analysis results in real time, during or after the game. Position graph, 5-tier candidate move color-coding, territory display, and thinking time highlights let you objectively assess the board state.

6.1 Position Graph

6.2 Candidate Moves (5-Tier Color Coding)

AI-recommended top candidates are displayed on the board.

TierColorCondition (Difference from #1)
1BlueBest move
2Green≤ 2 points AND ≤ 2%
3Yellow≤ 5 points AND ≤ 5% (black text)
4Orange≤ 10 points AND ≤ 10%
5RedBeyond

6.3 Territory Overlay

Tapping the "map icon" displays AI-predicted territory on the board.

SettingBehavior
Color onlyFixed size, expressed by intensity. Black territory opacity 0.05–0.65 / White 0.08–0.85.
Size onlyFixed intensity, expressed by size. Non-linear curve (exponent 0.65) emphasizes "weaker side differences."
BothExpressed by both size and intensity.

6.4 Thinking Time Visualization

— 06 —

Chapter 7: Review Mode

F-205 to F-208, F-220-2, F-220-3

What You Can Do in This Chapter: Tap the board from any position to try your own moves. Variations are managed by tabs, and PV ghost playback and variation trees give you a full overview. Jump to any position instantly from the position graph, game record list, or tree.

7.1 Creating Variations

Variation Management Internals

7.2 PV (Recommended Sequence) Playback

PV Preview Internals

7.3 Variation Tree

Displays the full overview of all variations in tree format. Tapping any node jumps to that position. The rightmost column shows each move's "score difference" and "cumulative," letting you visually grasp position changes.

7.4 Position Navigation (Cross-Jumping)

Go Lab provides multiple routes to access the same position from different screens.

RouteStarting PointDestination
Position graph tapAny position on graphJump to that move number
Game record list tapAny move in recordJump to that position
Variation tree node tapAny node in treeJump to that position

7.5 Board Tap Control During Review Mode

— 07 —

Chapter 8: Report Generation

F-209, F-210

What You Can Do in This Chapter: Analyze bad moves in two report types: "Score Drop" and "Winrate Drop." Includes comparison with AI-recommended moves, value gap display, and PDF/image save/share.

8.1 Two Report Types

Report TypeTarget Move Extraction ConditionsSort Key
Score Drop Only moves by the specified side / Score drop ≥ 1.0 point / Does not match AI best move / Has evaluation Descending score drop
Winrate Drop Same as above + Winrate drop ≥ 2.0% AND score drop ≥ 1.0 point Descending winrate drop

8.2 5-Tier Bad Move Evaluation

EvaluationScore Drop RangeMeaning
GoodLess than 1.0 pointClose to the best move
Normal1.0–2.5 pointsMinor loss
Doubtful2.5–5.0 pointsSomewhat questionable
Bad5.0–10.0 pointsBad move
Blunder10.0+ pointsMajor blunder

8.3 Comparison with AI-Recommended Move

The report shows both the "played move" and "AI-recommended move" side by side on the board, and you can also check the PV (recommended sequence) for "what if this move had been played."

8.4 Value Gap

The position difference between the "played move" and "AI-recommended move" is calculated as a pure value gap compared at the same position. When the played move equals the recommended move, it's defined as 0.0 points.

8.5 Low-Confidence Flag

If the visit count when the move was analyzed is less than 500, a "Low Confidence" flag is added. This is a safeguard against declaring a move as "bad" when the analysis isn't sufficiently precise.

8.6 Async Analysis and Progress Display

  1. Extract all candidate target moves
  2. For each candidate, if the "AI best move" isn't cached, re-analyze with the engine, filling in best move, position value, recommended sequence, and visit count in the game record
  3. Call a progress callback per move, showing "N / M" in the UI
  4. Narrow valid candidates to the specified count, generating highlight info for each move
  5. Calculate winrate change via sigmoid and embed

8.7 Report Output

— 08 —

Chapter 9: Game Record Management & SGF I/O

F-211, F-212, F-220-2

What You Can Do in This Chapter: Game history saved as one JSON file per game. SGF import/export lets you import records from other apps for analysis. Autosave lets you resume from the last move even if the app crashes.

9.1 SGF Import/Export

9.2 Game History Management

9.3 Autosave and Resume

9.4 Position Jump from Game Record

— 09 —

Part III: Learning, Lessons & Tsumego

Chapter 10: Tsumego

F-301 to F-306

What You Can Do in This Chapter: A large collection of practical Tsumego problems. Filter by move count or status; the AI plays responses. Multiple solution visualization, solution playback, and streak features support daily learning habits.

10.1 Problem Structure

10.2 Solution Judgment and AI Response

10.3 Multiple Solution Visualization

Multiple Solution Display: When there are multiple correct answers, playing one shows the other solution candidates as green dashed circles on the board. A highly educational effect that reveals "there were other options."

10.4 Solution Playback Mode

10.5 Progress Management and Streaks

10.6 Correct Answer Celebration

3-Stage Animation

  1. Checkmark Spin-In: Rotates from -180° → 0° while springing from scale 0.2 → 1.0.
  2. Star Burst: 14 stars scatter radially. Angle is 2π/14 with ±0.15rad jitter; distance 90–160pt; size 12–24pt.
  3. Message Pop: "Solved!" message and buttons pop up with spring. Streak count shown as 🔥 N day streak in an orange capsule.

* Internal name: "Kururin~Pa! Kira~n" (spin-pop-sparkle). Presented as "Correct Answer Celebration" in the product introduction.

— 10 —

Chapter 11: Lessons

F-307 to F-310

What You Can Do in This Chapter: Learn Go from basics to advanced topics with a Live2D character as your guide. A "Read → Try → Solve" three-stage structure with board-interactive materials and tests enables active learning.

11.1 Lesson Curriculum Structure

Curriculum Intent: Rather than just "read and understand," interactive tests where you actually tap the board between lessons encourage active learning instead of passive reception. The "multiple solution dashed circles" mechanism is shared with Tsumego, showing other solution candidates when there are multiple correct answers.

11.2 Live2D Character Integration

11.3 Board-Linked Explanations and Captions

11.4 Level Management and Multilingual Support

— 11 —

Part IV: Engine, System & Data Management

Chapter 12: System Overview & Requirements

F-401

What You'll Learn in This Chapter: An overview of how Go Lab is technically structured and what devices it runs on.

12.1 System Requirements

ItemRequirement / Specification
Supported OSiOS 15.0+ / iPadOS 15.0+
Supported DevicesiPhone, iPad (Apple Silicon devices recommended)
Storage~1GB+ free space when using High model
NetworkRequired for online play, OGS watch, and model download
Offline OperationCPU games, Tsumego, and lessons work fully offline

12.2 App Structure

— 12 —

Chapter 13: AI Engine "KataGo" Technical Specifications

F-402, F-402-1, F-403, F-404

What You'll Learn in This Chapter: Technical specifications of the KataGo engine at the core of Go Lab: three models, backends, and inference parameters.

13.1 Model Types and Technical Differences

ModelBackendParametersFeatures
Light (b6c96) Metal (GPU) ~1.03M Bundled with app. Lightweight and fast. g170 generation.
High (b18c384nbt) CoreML (ANE) ~26.33M Additional DL required. High inference accuracy. kata1 generation.
HumanSL CoreML (ANE) ~26.33M + human imitation layer Additional network trained on human game data, based on the High model.

* Parameter counts based on the publicly available KataGo network architecture.

13.2 Model Selection and Availability

13.3 Backend Differences

In simulator environments, Metal + b6c96 is automatically used.

13.4 Engine Inference Parameters

— 13 —

Chapter 14: Settings & Data Persistence

F-405, F-406

What You Can Do in This Chapter: View the app's settings (Engine / Display) in one place. Learn about the data persistence method and autosave mechanism.

14.1 Settings List

TabItemRange / Spec
EngineModel in useLight / High / HumanSL
EngineModel download/deleteAdditional DL/delete for High/HumanSL
EngineAnalysis Visits (evaluation)40–1000 (default: 100)
EngineAnalysis Visits (candidates)64–1000 (default: 280)
EngineHumanSL profilerank_20k–rank_9d / preaz_*
DisplayShow lesson tabON / OFF
DisplayBoard styleWood / Plain
DisplayTerritory displayColor only / Size only / Both
DisplayCandidate move count3–30

14.2 Data Persistence

14.3 Autosave Robustness

Support: If you encounter an unresolved issue, please contact support ([email protected]). Include the app version, device name, and details of the problem.

— 14 —

Chapter 15: Model Management & App Operations

F-407, F-408, F-409

What You'll Learn in This Chapter: Mechanisms for downloading/deleting AI models, review request rules, and release note / forced update behavior.

15.1 Model Download Manager

15.2 Review Request

15.3 Release Notes and Forced Update

— 15 —

Chapter 16: Communication & Online Play Robustness

F-410, F-411

What You'll Learn in This Chapter: Mechanisms that keep games from breaking down even if the network becomes unstable during online play.

16.1 Background Departure Timer

16.2 Detecting Opponent Resignation and Game End

16.3 Move Count Sync

16.4 Network Recovery

16.5 Duplicate Send Prevention

— 16 —

Cross-cutting

Chapter 17: UI/UX Refinements & Hidden Conveniences

F-501 to F-505

What You'll Learn in This Chapter: Design refinements common to the whole app — board operation comfort, immersive effects, Zen Mode, physics animations, and more.

17.1 Board Operation Comfort and Error Prevention

17.2 Immersion-Enhancing Effects and Feedback

17.3 Analysis & Review Conveniences

17.4 Learning & Lesson Refinements

17.5 Online & OGS Integration Conveniences

17.6 Zen Mode Operation Scheme

17.7 Other Fine UX/Support Features

17.8 Other Hidden Considerations

— 17 —

Appendix: Feature Master Ledger

The master ledger of all features covered on this page. Used as the source of truth for future updates. Status legend: ✅ Feature = directly usable by users / 🔧 Internal = internal behavior / 📄 Doc = documentation item / 📂 Category = parent feature ID (bundling children) / ❓ Unverified = code unconfirmed.

Part I: Play & Online Play

IDFeature NameCh.StatusParentRelated
F-101Game Modes (CPU / Local / Online)1✅ Feature—F-111, F-113
F-102Rule Sets1✅ Feature—F-107
F-103Game End (Two Passes / Resign)1✅ Feature—F-104
F-104Dead Stone Judgment1✅ Feature—F-103
F-105Handicap Stones (AB/AW)1✅ Feature—F-106
F-106Side Selection (Black/White)1✅ Feature—F-105
F-107Board Size × Rule Combinations1✅ Feature—F-102
F-108Difficulty Lv.1–632✅ Feature——
F-109HumanSL (Modern/Classic)3✅ Feature—F-110
F-110Play/Analysis Model Separation3✅ Feature—F-109
F-111Online Play4✅ Feature—F-101
F-112OGS Watch5✅ Feature——
F-113OGS Play5✅ Feature—F-101
F-114OGS Time Control5✅ Feature—F-113

Part II: AI Analysis, Review & Game Records

IDFeature NameCh.StatusParentRelated
F-201Position Graph6✅ Feature—F-220-1
F-202Candidate Moves (5-Tier Color)6✅ Feature——
F-203Territory Overlay6✅ Feature——
F-204Thinking Time Visualization6✅ Feature——
F-205Review Mode (Variation Creation)7✅ Feature—F-206, F-207, F-208
F-206PV Ghost Playback / Bulk Apply7✅ Feature—F-205
F-207Variation Tree7✅ Feature—F-220-3
F-208Forward-Match Variation Merge7✅ Feature—F-205
F-209Report Generation8✅ Feature—F-210
F-2105-Tier Bad Move Eval / AI Move Comparison8✅ Feature—F-209
F-211Game Record Management (JSON History)9✅ Feature—F-212
F-212SGF Import/Export9✅ Feature—F-211
F-220Position Navigation (Cross-Cutting)6, 7, 9📂 Category——
F-220-1Position Graph Tap-to-Jump6✅ FeatureF-220F-201
F-220-2Game Record List Tap-to-Jump7, 9✅ FeatureF-220F-205, F-211
F-220-3Tree Node Jump7✅ FeatureF-220F-207
F-220-4Variation List → Variation NavigationTBD❓ UnverifiedF-220—
F-220-5Variation Drill → Position NavigationTBD❓ UnverifiedF-220—

Part III: Learning, Lessons & Tsumego

IDFeature NameCh.StatusParentRelated
F-301Tsumego Problem Structure10✅ Feature——
F-302Solution Judgment & AI Response10✅ Feature—F-303, F-304
F-303Multiple Solution Display10✅ Feature—F-302
F-304Solution Playback Mode10✅ Feature—F-302
F-305Progress Management / Streaks10✅ Feature——
F-306Correct Answer Celebration10✅ Feature—F-302
F-307Lessons (Live2D)11✅ Feature—F-308, F-309
F-308Board-Linked Explanations11✅ Feature—F-307
F-309Curriculum Structure11✅ Feature—F-307
F-310Level Management / Multilingual11✅ Feature—F-307

Part IV: Engine, System & Data Management

IDFeature NameCh.StatusParentRelated
F-401System Overview & Requirements12📄 Doc——
F-402KataGo Model Types13📄 Doc—F-402-1
F-402-1Model Selection / Availability Check13✅ FeatureF-402F-110
F-403Backends (Metal / CoreML)13📄 Doc—F-402
F-404Inference Parameters (Visits)13📄 Doc—F-108
F-405Settings List14✅ Feature——
F-406Autosave / Resume Hint14✅ Feature—F-211
F-407Model Download Manager15🔧 Internal—F-402-1
F-408Review Request15🔧 Internal——
F-409Release Notes / Forced Update15🔧 Internal——
F-410Network Recovery / Duplicate Send Prevention16🔧 Internal—F-111, F-113
F-411Background Departure Timer16🔧 Internal—F-111

Cross-cutting: UI/UX

IDFeature NameCh.StatusParentRelated
F-501Board Operation (Follow/Zoom/Pan)17✅ Feature——
F-502Physics Animations17🔧 Internal——
F-503Zen Mode17✅ Feature——
F-504Haptic Feedback17🔧 Internal——
F-505Other Hidden Considerations17🔧 Internal——

Unverified Items: F-220-4 (Variation List → Variation Navigation) and F-220-5 (Variation Drill → Position Navigation) are marked "❓ Unverified" because the corresponding UI could not be confirmed in the provided source code. Once the implementation is confirmed, the status and chapter will be updated.

Note: This page is a technical document generated by AI analyzing the app's Swift source code. Actual app specifications and behavior may differ in detail. Please be aware of this in advance.

Back to Go Lab Home