# tuguang2025/hcaptcha-solver- architecture

> Architecture diagram of the GitHub repository tuguang2025/hcaptcha-solver-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tuguang2025/hcaptcha-solver-
- Repository: https://github.com/tuguang2025/hcaptcha-solver-

## Overview

This repository combines a Discord registration script with an hCaptcha solver. The principal workflow is registration attempt → challenge data → solver → CAPTCHA token → registration retry. The solver fetches challenge material, builds motion data, obtains text answers through Groq, and submits the challenge. The README also reports Discord phone verification as a side effect. Edges reflect the excerpts and README; unsampled behavior is not inferred.

Main entry points: [`solver.py`](https://github.com/tuguang2025/hcaptcha-solver-/blob/main/solver.py) (Solver orchestration), [`discordregister-test.py`](https://github.com/tuguang2025/hcaptcha-solver-/blob/main/discordregister-test.py) (Registration client), [`main.py`](https://github.com/tuguang2025/hcaptcha-solver-/blob/main/main.py) (HSW execution), [`motion.py`](https://github.com/tuguang2025/hcaptcha-solver-/blob/main/motion.py) (Motion data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_registration["Registration"]
  node_register["Registration client"]
end

subgraph group_solving["Challenge solving"]
  node_solver["Solver orchestration<br/>[solver.py]"]
  node_motion["Motion data<br/>[motion.py]"]
  node_hsw["HSW execution<br/>[main.py]"]
end

subgraph group_support["Runtime support"]
  node_browser["Chromium browser"]
  node_logger["Logging<br/>[logger.py]"]
end

node_operator(("Operator"))
node_discord["Discord API"]
node_captcha["hCaptcha API"]
node_groq["Groq language model"]

node_operator -->|"runs"| node_register
node_register -->|"requests registration"| node_discord
node_discord -->|"returns challenge"| node_register
node_register -->|"requests token"| node_solver
node_solver -->|"fetches and submits"| node_captcha
node_solver -->|"gets motion data"| node_motion
node_solver -->|"computes HSW"| node_hsw
node_hsw -->|"runs script"| node_browser
node_hsw -->|"fetches HSW assets"| node_captcha
node_solver -->|"requests answers"| node_groq
node_solver -->|"logs events"| node_logger
node_register -.->|"may trigger phone verification"| node_discord

click node_register "https://github.com/tuguang2025/hcaptcha-solver-/blob/main/discordregister-test.py"
click node_solver "https://github.com/tuguang2025/hcaptcha-solver-/blob/main/solver.py"
click node_motion "https://github.com/tuguang2025/hcaptcha-solver-/blob/main/motion.py"
click node_hsw "https://github.com/tuguang2025/hcaptcha-solver-/blob/main/main.py"
click node_logger "https://github.com/tuguang2025/hcaptcha-solver-/blob/main/logger.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_register toneBlue
class node_solver,node_motion,node_hsw toneAmber
class node_browser,node_logger,node_discord,node_captcha toneMint
class node_operator,node_groq toneIndigo
```

## Components

### Registration

- [Registration client](https://github.com/tuguang2025/hcaptcha-solver-/blob/main/discordregister-test.py): `discordregister-test.py`

### Challenge solving

- [Solver orchestration](https://github.com/tuguang2025/hcaptcha-solver-/blob/main/solver.py): `solver.py`
- [Motion data](https://github.com/tuguang2025/hcaptcha-solver-/blob/main/motion.py): `motion.py`
- [HSW execution](https://github.com/tuguang2025/hcaptcha-solver-/blob/main/main.py): `main.py`

### Runtime support

- **Chromium browser**
- [Logging](https://github.com/tuguang2025/hcaptcha-solver-/blob/main/logger.py): `logger.py`

### Other components

- **Operator**
- **Discord API**
- **hCaptcha API**
- **Groq language model**

## Connections

- Operator → Registration client: runs (evidence: `discordregister-test.py`)
- Registration client → Discord API: requests registration (evidence: `discordregister-test.py`)
- Discord API → Registration client: returns challenge (evidence: `discordregister-test.py`)
- Registration client → Solver orchestration: requests token (evidence: `discordregister-test.py`)
- Solver orchestration → hCaptcha API: fetches and submits (evidence: `solver.py`)
- Solver orchestration → Motion data: gets motion data (evidence: `solver.py`)
- Solver orchestration → HSW execution: computes HSW (evidence: `solver.py`)
- HSW execution → Chromium browser: runs script (evidence: `main.py`)
- HSW execution → hCaptcha API: fetches HSW assets (evidence: `main.py`)
- Solver orchestration → Groq language model: requests answers (evidence: `solver.py`)
- Solver orchestration → Logging: logs events (evidence: `solver.py`)
- Registration client → Discord API: may trigger phone verification (evidence: `README.md`)