bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 16쪽 중 12쪽
922b3fd-2c6f-4465-8193-75ae8e82dcd8" alt=""><figcaption></figcaption></figure>
{% hint style="success" %}
If you have previously logged in, it will skip this step. Otherwise, log in using the browser window that just opened.
{% endhint %}
#### Play Minecraft
Next, the terminal will display a **START MINECRAFT** section:
1. Prompts you to wait for two Minecraft windows to open (up to 5 minutes)
2. Do not close either Minecraft window manually. The app manages them.
{% hint style="warning" %}
**Important:** If one or both windows close, restart the program.
{% endhint %}
3. Run `tail -f logs/malmo.log` in another terminal to monitor for errors.
4. Press `ENTER` when both Minecraft windows are open and ready.
<figure><img src="https://1034405018-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIcazOdplbOmP4R0T7sG8%2Fuploads%2FHW3SMA6q6sIzyjWed86o%2Fmojang_open.png?alt=media&token=f90e9309-69e4-4dfd-9b30-eb0189438396" alt=""><figcaption></figcaption></figure>
### Game Instructions
The objective is to construct the structure in front of you by adding or removing blocks. Each attempt to build is referred to as an "episode." The AI player learns from your actions as you continue to play.
#### Game Controls
* Click on the Minecraft window and press **ENTER** to start playing
* Break red blocks and place blocks where indicated
* **Left click** to break blocks & **right click** to place blocks
* Select tools/blocks by pressing number keys **1-9**
* Use **WASD** keys to move around
* Press **ESC** when finished, then return to the terminal
<figure><img src="https://1034405018-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIcazOdplbOmP4R0T7sG8%2Fuploads%2F6gI6VRrvw68dTfdbzFap%2Fepisode_playtime_instructions.png?alt=media&token=4545b42f-bedb-40de-8f2a-fbe50d12b380" alt=""><figcaption></figcaption></figure>
#### Record an Episode
The terminal will show a **STARTING EPISODE 0** section. 
At this stage, the program:
* Waits for the mission to load in Minecraft
* Begins recording your gameplay with a progress bar and timer
* Press `ENTER` when finished to stop recording
<figure><img src="https://1034405018-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIcazOdplbOmP4R0T7sG8%2Fuploads%2FA3Ygd6zXZ9RIH2NtXiBA%2Fplaying_minecraft_demo.gif?alt=media&token=605ec7e3-71ad-489b-9848-bb1121296317" alt=""><figcaption></figcaption></figure>
{% hint style="warning" %}
**Note:** You may need to press `ENTER` multiple times to stop recording.
{% endhint %}
### Training Process
When the terminal displays the `MODEL TRAINING` section, BlockAssist begins training the AI model based on your recorded gameplay. 
This process can take some time depending on your hardware performance, so keep the terminal window open until training completes. You’ll see progress updates and status indicators as the model trains.
<figure><img src="https://1034405018-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIcazOdplbOmP4R0T7sG8%2Fuploads%2FqislpMV9veWWvBWKepLs%2Frunning_training.png?alt=media&token=83fc88eb-817c-47c7-9a4a-e52093522708" alt=""><figcaption></figcaption></figure>
A model will now be trained and submitted to Hugging Face and Gensyn's smart contract.
#### Reviewing Logs
If you reach this stage in the logging window, and can see a transaction in the block explorer, then submissions have worked!
Logging Window:
```
[2025-07-28 05:03:48,955][blockassist.globals][INFO] - Successfully uploaded model to HuggingFace: h-grieve/blockassist-bc-bellowing_pouncing_horse_1753675374 with size 20.00 MB
```
You can see the details of the contract & transaction in the [Gensyn Testnet block explorer.](https://gensyn-testnet.explorer.alchemy.com/address/0xE2070109A0C1e8561274E59F024301a19581d45c?tab=logs)
```
huggingFaceID
string
false
h-grieve/blockassist-bc-bellowing_pouncing_horse_1753675374
```
The program will then end. Please close any Minecraft windows if they remain open, but only after you've confirmed the transaction and model upload, or you may lose your training progress.
### Testing & Contributing
Contributions to BlockAssist are welcome, whether through code improvements, testing, or documentation feedback. 
The following tools and options help you maintain a **\[1]** consistent and **\[2]** privacy-respecting development environment.
#### Telemetry
Running the following command disables **anonymous usage data** for your session. Paste this in the same terminal before starting the app:
```bash
export DISABLE_TELEMETRY=1
```
To make this change **permanent**, add the same line to your `~/.zshrc`.
{% hint style="danger" %}
Telemetry is completely optional. However, if you disable telemetry, your contributions may not be counted towards the [BlockAssist leaderboard](https://dashboard.gensyn.ai/).
{% endhint %}
#### Linting / Testing
This project uses [Ruff](https://github.com/astral-sh/ruff) to keep code tidy, which sorts imports and auto-fixes simple style issues.
How to run (from the project folder):
```bash
ruff check --select I --fix .
```
If you see `ruff: command not found`, install it once using this command:
```bash
pyenv exec pip install ruff
```
{% hint style="success" %}
If you need additional support, you can [open a ticket](https://github.com/gensyn-ai/blockassist/issues) or [visit our Discord.](https://discord.com/invite/gensyn) 
{% endhint %}
# Running BlockAssist with Cursor
This guide shows non-technical users how to set up and run BlockAssist on macOS using Cursor, an AI-powered code editor with an integrated chat assistant.
### Prerequisites
Make sure you have **essential deverloper tools** installed by using the commands below, depending on your operating system (OS). 
{% tabs %}
{% tab title="Windows (WSL 2)" %}
Run this command inside your WSL 2 terminal
```bash
sudo apt update && sudo apt install -y build-essential curl git zip unzip
```
{% endtab %}
{% tab title="Linux" %}
Run this command inside your Ubuntu terminal:
```bash
sudo apt update && sudo apt install -y build-essential curl git zip unzip
```
{% endtab %}
{% tab title="macOS" %}
Run this command inside your macOS terminal:
```bash
xcode-select --install
```
{% endtab %}
{% endtabs %}
### Step 1 — Install Cursor
Go to the [Cursor website](https://cursor.com/) and click Download.
### Step 2 — Set up your Workspace
Open the Cursor app and, on the welcome screen, click *"Clone repo".*
1. Select GitHub from the dropdown and paste `https://github.com/gensyn-ai/blockassist/` 
2. Pick a local folder where the code will be downloaded.
Once the download finishes, Cursor will open your `blockassist` local folder.
### Step 3 — Install Dependencies
{% hint style="info" %}
You only need to do this once. To record additional episodes, skip to [Running BlockAssist.](/testnet/blockassist/using-blockassist)
{% endhint %}
You should be able to see the "Chat" panel of Cursor on the right side of the screen. If you don’t see the Chat panel, press `ctrl+L` (Windows/Linux) or `cmd+L` (macOS). 
In the chat window, enter the following prompt:
```
help me install the right dependencies for my operating system according to README.md
```
Cursor will now guide you through the installation steps of various dependencies needed to run BlockAssist. At the end, you should see a message saying the installation is complete.
{% hint style="warning" %}
**macOS Users:** You will need to give Cursor permission to minimize the Minecraft AI assistant window while you play the game. To do this, go to `System Settings` > `Privacy & Security` > `Accessibility` and set the toggle next to Cursor to `ON`.
{% endhint %}
## Troubleshooting
If you see any errors while trying to install or run BlockAssist, Cursor may be able to help you fix the issue and get unblocked.
Otherwise, you can go to the **troubleshooting guides** for your respective operating system by clicking the cards below:
<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Windows (WSL 2)</td><td><a href="/testnet/blockassist/getting-started/windows-wsl-2#troubleshooting">Windows (WSL 2)</a></td></tr><tr><td>Linux</td><td><a href="/testnet/blockassist/getting-started/linux#troubleshooting">Linux</a></td></tr><tr><td>macOS</td><td><a href="/testnet/blockassist/getting-started/macos#troubleshooting">macOS</a></td></tr></tbody></table>
#### Handling Errors in Cursor
To help you understand and fix an error you see in your Terminal, go to the Chat panel on the right and enter the following prompt: 
```
Help me fix this error
```
* Make sure that Cursor AI can see the error, by clicking on `Add Context` in the chat box and then selecting `Terminal(s)`
* Alternatively, you can also copy and paste the error you see to the chat next to the prompt above.
If you don't see an error but BlockAssist isn't working as expected, you can also ask Cursor to look at your log files. Try using this prompt: 
```
Look at my logs folder and see if there are any errors preventing BlockAssist from running as expected
```
You can then follow the recommendations from Cursor to help you fix any issues and get unblocked. 
{% hint style="success" %}
If you need additional support, you can [open a ticket](https://github.com/gensyn-ai/blockassist/issues) or [visit our Discord.](https://discord.com/invite/gensyn) 
{% endhint %}
# Hugging Face Guide
Follow this quick tutorial to sign up for Hugging Face and generate a private token for use with BlockAssist.
## Getting Tokens for BlockAssist
BlockAssist uses Hugging Face to securely host and share AI models, linking them to your Gensyn Testnet account. Hugging Face ensures models are accessible, auditable, and reusable within the AI ecosystem.
#### Step 1 — Sign Up 
Go to [Hugging Face](https://huggingface.co/login) and click **Sign Up** in the top right to create a free account. 
* You can sign up with email/password, or through Google or GitHub
* Already have an account? Click **Sign In.** 
{% hint style="success" %}
If you have trouble signing up, try a different browser or disable ad blockers.
{% endhint %}
#### Step 3 — Verify your Email (required)
After signing up, check your inbox for a Hugging Face verification email. Then, click the link in the email to verify your address.
This step is required before you can create tokens or upload anything.
{% hint style="warning" %}
Can't find it? Check your spam folder. or log in and click **“Resend Verification”.**
{% endhint %}
#### Step 3 — Generate a New Access Token
This token allows the game to upload a model to your Hugging Face account.
1. Once signed in, click your **profile icon** (top right corner).
2. Select **“Access Tokens”** from the dropdown.
3. Click **“New token”.**
* **Name:** something like “BlockAssist”.
* **Role:** choose **Write.**
4. Click **“Create”.**
5. **Copy the token immediately,** as you won’t be able to see it again.
{% hint style="info" %}
When prompted to paste the token, be aware that the token will be **invisible** when pasted, so you won't see it entered into the terminal. Simply paste, then hit `enter` (Windows/Linux) or `return` (macOS).
{% endhint %}
### Common Issues
Here's some common blockers and quick fixes if you encounter any problems regarding Hugging Face:
| Issue | Solution |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Not seeing "Access Tokens" menu | Make sure you’re logged in and your email is verified. |
| Copied the token, but didn't save it | Delete the lost token and generate a new one. Be sure to save it! |
| 403 Client Error: Forbidden | Your token might not have *Write* permissions, or may have expired. Generate a new token with Write access. |
| Uploaded model doesn't appear on Hugging Face | Refresh your Hugging Face profile and check under Repositories → Models and confirm you’re logged into the same Hugging Face account that owns the token. |
| Multiple tokens created, not sure which is active | Delete unused tokens in Settings → Access Tokens. Keep only the one you use for BlockAssist to avoid confusion. |
### Using your New Token with BlockAssist
You're ready to go! 
Paste your token during game setup, [which you can read about here](/testnet/blockassist/using-blockassist), and start training models and contributing to the Gensyn Testnet. 
{% hint style="success" %}
If you need additional support, you can [open a ticket](https://github.com/gensyn-ai/blockassist/issues) or [visit our Discord.](https://discord.com/invite/gensyn) 
{% endhint %}
# CodeAssist (Paused)
CodeAssist is an AI assistant that learns from every edit, keystroke, and solution, adapting to your style and training itself to become the perfect coding partner for you.
{% hint style="warning" %}
**CodeAssist has been sunset.**
As Gensyn prepares for Mainnet, we're consolidating focus around [Delphi](https://app.delphi.fyi/). CodeAssist demonstrated how ML models can train directly on human interactions to create personalized, privacy-preserving models that keep user data local. 
*These docs are preserved for reference but CodeAssist is no longer actively maintained.*
Alternatively, you can explore [Delphi](https://app.delphi.fyi/), a set of tools for creating information markets.
{% endhint %}
### What is CodeAssist?
CodeAssist opens locally in your browser and turns everyday coding into a learning experiment.
You solve short programming challenges based on LeetCode-style problems, while an on-device model observes your approach, refactors, and final solutions. Over time, the model begins to imitate your reasoning: how you structure loops, name variables, debug logic, and refine solutions.
Each coding session becomes a training “episode,” producing data the app uses to adapt its next set of suggestions.
{% hint style="info" %}
CodeAssist offers a simple, reproducible sandbox for learning. It uses lightweight, single-file challenges without external libraries or tools: just a prompt, code editor, and a test runner.
{% endhint %}
<div data-with-frame="true"><figure><img src="https://1034405018-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIcazOdplbOmP4R0T7sG8%2Fuploads%2F25VZML0KMXlfDuOUNWvO%2Fcodeassist_selecting_different_problems.gif?alt=media&token=8f2b8927-1278-48a0-8179-758957e02fbd" alt=""><figcaption></figcaption></figure></div>
### Why It Exists
Most AI coding tools are pre-trained on large static datasets. They either autocomplete or autosuggest code based on the context available to them, but they don't *learn* from you. 
CodeAssist is an interactive product that explores a new paradigm, being a code assistant that evolves from your own problem-solving style. It's built to demonstrate "assistance learning", a branch of RL where the user becomes the teacher. 
Much like BlockAssist, which learns Minecraft gameplay by mimicking user actions and receiving feedback through user intervention, CodeAssist models are trained to reinforce programming concepts and principles through editing, deleting, or retaining the assistant's output.
By grounding this in a lightweight, browser-based environment, CodeAssist provides a simple, auditable example of decentralized training and coordination in action.
{% hint style="info" %}
CodeAssist and [BlockAssist](/testnet/blockassist) demonstrate “assistance learning”, where AI that learns directly from human actions, not just static datasets while giving users a hands-on way to contribute to and experiment with decentralized AI training.
{% endhint %}
### How It Works
CodeAssist gives you a hands-on way to contribute to and experiment with decentralized AI training while improving your LeetCode skills. 
1. **Start Locally:** Launch CodeAssist in your browser. Each sessions spins up a contained coding environment. 
2. **Choose a Problem:** Select one of the available problems from the training set. 
3. **Code and Test:** CodeAssist tracks your edits and cursor movements, suggesting code additions like new lines, comments, and functions. It may also edit your code.
4. **Learn and Adapt:** After recording your "episode," the model reviews data from your coding session to learn your preferences and patterns.
5. **Iterate:** In the following sessions, CodeAssist continues fine-tuning the local model to seed new suggestions, like completions, refactors, and hints, based on the patterns it learned. The model will improve to code more like *you* over time.
6. **(Optional) Upload to Hugging Face:** Once you’re happy with your personal CodeAssist model, you can share it on Hugging Face and track your contribution to a decentralized, verifiable ledger of model improvements on the Gensyn Testnet.
#### Why LeetCode?
All CodeAssist coding prompts are drawn from LeetCode-style problems.
We use them as a lightweight, well-understood medium for training because they strike a balance between simplicity and structure. 
They are:
1. **Self-contained:** These single-file challenges that run directly in your browser with no dependencies or setup. 
2. **Familiar:** Many developers already understand the format, which reduces friction when learning a new tool. 
3. **Measured and gradable:** Each problem has clear test cases and difficulty levels, which provides a natural way to track model progress. 
4. **Accessible:** CodeAssist leverages an existing public dataset of problems and test suites to ensure consistency across users.
{% hint style="success" %}
Using LeetCode as the sandbox keeps CodeAssist lightweight, fair, and approachable, so the focus stays on how *you* solve problems, not on configuring an environment.
{% endhint %}
#### Get Started
Ready to spin up CodeAssist and start training a local machine learning model (ML) to code like you today? Choose one of the installation guides below, or head directly to [this walkthrough guide.](/testnet/codeassist/using-codeassist)
<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Windows (WSL 2)</strong></td><td><a href="/testnet/codeassist/getting-started/windows-wsl-2">Windows (WSL 2)</a></td></tr><tr><td><strong>Linux (Ubuntu 22.04+)</strong></td><td><a href="/testnet/codeassist/getting-started/linux">Linux</a></td></tr><tr><td><strong>macOS (Intel & ARM)</strong></td><td><a href="/testnet/codeassist/getting-started/macos">macOS</a></td></tr></tbody></table>
# Getting Started
Get up and running with CodeAssist and start training local models based to code like you.
{% embed url="<https://github.com/gensyn-ai/codeassist>" %}
{% hint style="warning" %}
CodeAssist has been sunset. Please see the [home page](/testnet/codeassist) for more information.
{% endhint %}
## Overview
This page helps you prepare your system and choose the correct installation path for CodeAssist. 
It provides a readiness checklist, supported platforms, and an overview of the setup process before you begin installing and running CodeAssist on your device.
<div data-with-frame="true"><figure><img src="https://1034405018-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIcazOdplbOmP4R0T7sG8%2Fuploads%2Ffus2lHjVF59ATZsxiNRa%2Fimage.png?alt=media&token=7803e486-e7c1-4bab-b223-3f451e96246e" alt=""><figcaption></figcaption></figure></div>
### Before you Begin
CodeAssist is available across several environments: [Windows (via WSL 2)](/testnet/codeassist/getting-started/windows-wsl-2), [Linux (Ubuntu 22.04+)](/testnet/codeassist/getting-started/linux), and [macOS (Intel and Appl프로젝트로 돌아가기
