bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 16쪽 중 13쪽
e Silicon).](/testnet/codeassist/getting-started/macos)
{% hint style="info" %}
A virtual private server (VPS) is **not** required to run CodeAssist.
{% endhint %}
Before you start, make sure you meet the basic requirements and have the necessary accounts.
#### System Requirements <a href="#system-requirements" id="system-requirements"></a>
* 8 GB RAM minimum (32 GB recommended)
* Stable internet connection
* At least 10 GB of available storage (for overhead)
* Modern multi-core CPU (Intel, AMD, or Apple Silicon)
#### Software Requirements
* [Docker](https://docs.docker.com/engine/install/)
* [Python 3.10+](https://www.python.org/downloads/)
* [Homebrew](mailto:undefined) (if installing on [macOS](/testnet/codeassist/getting-started/macos))
* [Git](https://git-scm.com/install) (for cloning the repo)
#### Accounts & Access
* **Hugging Face account:** You’ll need a Write-access API token to upload your model after training. See the [Hugging Face Guide](/testnet/codeassist/hugging-face-guide) for instructions.
* **Gensyn Testnet account:** Automatically created when you first log in through your browser during setup.
{% hint style="info" %}
When logging in, different types of External Object Identifiers (EOA) are assigned based on the authentication method used. 
Google authentication typically assigns an EOA linked to the user's Google account. On the other hand, logging in via OTP (One-Time Password) often results in an EOA tied to the mobile number or email address used for the OTP process.
{% endhint %}
#### Quickstart
You can find the quickstart commands for cloning the repository and installing dependencies below. If you take this route, it's recommended to use an IDE like Cursor in case you experience any initial issues. 
1. Run this sequence of commands in your terminal:
```bash
git clone https://github.com/gensyn-ai/codeassist
cd codeassist
uv run run.py
```
2. Open CodeAssist, load a LeetCode problem, and check that the container starts successfully.
3. You can also use the following commands to verify you've installed all the required dependencies correctly:
```bash
docker --version
python3 --version
uv --version
```
If you encounter any errors, head over to the [Troubleshooting](/testnet/rl-swarm/troubleshooting) page.
### Supported Platforms & Installation Paths
See platform-specific installation instructions below.
<table data-view="cards"><thead><tr><th></th><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>Install, run, and train models in a Linux-based Windows environment. </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>Install CodeAssist natively on Ubuntu or a compatible distribution for the most stable experience.</td><td><a href="/testnet/codeassist/getting-started/linux">Linux</a></td></tr><tr><td><strong>macOS (Intel & Apple Silicon)</strong></td><td>Install and run CodeAssist on macOS devices using <code>brew</code> or <code>curl</code> for dependency management. Both Intel and M-Series CPUs are supported. </td><td><a href="/testnet/codeassist/getting-started/macos">macOS</a></td></tr></tbody></table>
# Windows (WSL 2)
Get up and running with CodeAssist in your Windows (WSL 2) environment.
## Overview
This guide explains how to install and run CodeAssist on Windows using the Windows Subsystem for Linux 2 (WSL 2).
### Prerequisites
Before installing CodeAssist, make sure you have:
* Windows 10 or 11 with WSL 2 enabled and running. 
* A Linux distribution installed under WSL 2
* Administrator privileges on your device
* A [Hugging Face](https://huggingface.co/) account for authentication
### Dependencies
CodeAssist requires the following software components:
| Dependency | Purpose | Minimum Version |
| ------------------------------------------------- | ------------------------------------------------------ | --------------- |
| [Docker](https://docs.docker.com/engine/install/) | Runs the isolated CodeAssist container environment | Latest stable |
| [Python](https://www.python.org/downloads/) | Executes the environment management and web UI Scripts | 3.10+ |
| UV | Manages Python dependencies and virtual environments | Latest stable |
#### Docker & Python
Install [Docker](https://docs.docker.com/engine/install/) and [Python](https://www.python.org/downloads/) according to the installation steps for your platform. 
{% hint style="warning" %}
Make sure that Docker is open before trying to run CodeAssist. If this is your first time installing Docker, it should auto-open.
However, if you close or restart your system, **make sure to reopen the Docker desktop application,** or else you will encounter container connection failures.
{% endhint %}
#### UV
To install UV, a lightweight dependency manager used to handle the project's Python environment, use the following command inside your WSL 2 terminal:
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
You can then check if the installation was successful and check the version of UV installed with `uv --version`.
### Installation Steps
1. Open your WSL 2 terminal (Ubuntu or another distro).
2. Clone the CodeAssist repository:
```bash
git clone https://github.com/gensyn-ai/codeassist.git
cd codeassist
```
{% hint style="warning" %}
If you’re also running [RL Swarm](/testnet/rl-swarm) or another Docker-based Gensyn project, ensure that `port:3000` is free before launching CodeAssist.
{% endhint %}
#### Run CodeAssist
To open CodeAssist, run the following command in your terminal:
```bash
uv run run.py
```
The first run may take several minutes as Docker builds the environment and downloads required components. 
{% hint style="warning" %}
To ensure CodeAssist functions optimally, avoid modifying the `compose.yml` file. Editing this file undermines the run script's purpose and may prevent functionalities such as uploading trained models to Hugging Face, interacting with smart contracts, or earning Testnet participation points.
{% 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%2FCJviAQResNWriKqirOrA%2Fimage.png?alt=media&token=8585e94e-ca8e-4189-b0df-133eea259709" alt=""><figcaption></figcaption></figure></div>
Once running, CodeAssist automatically launches in your browser. If it doesn't, visit the following localhost URL and open it manually:
```url
http://localhost:3000
```
### Authentication 
CodeAssist uses Hugging Face tokens for authentication and model uploads.
1. Visit your **Hugging Face profile > Settings > Access Tokens.**
2. Generate a **New Token** with 'Write' access.
3. Copy the token string.
4. When starting CodeAssist, the application will prompt you for the token. Paste it into the terminal or web interface.
{% hint style="info" %}
Read the [Hugging Face Guide](/testnet/codeassist/hugging-face-guide) for help setting up a token, what it's used for, and basic troubleshooting.
{% endhint %}
### Next Steps
Once setup is complete, open CodeAssist, pick your first LeetCode-style problem, and start coding! 
You can view this [comprehensive walkthrough](/testnet/codeassist/using-codeassist) for instructions on how to use CodeAssist, any best practices and tips, and what to expect when training models, or visit the [Troubleshooting](/testnet/codeassist/troubleshooting) page if you need help setting up CodeAssist.
{% hint style="success" %}
If you need additional support, you can [open a ticket](https://github.com/gensyn-ai/codeassist/issues) or [visit our Discord.](https://discord.com/invite/gensyn)
{% endhint %}
# Linux
Get up and running with CodeAssist in your Linux (Ubuntu 22.04+) environment.
## Overview
This guide explains how to install and run CodeAssist on Linux. 
### Prerequisites
Before installing CodeAssist, make sure you have:
* A compatible Linux distribution (Ubuntu 22.04+ LTS recommended) 
* Administrator (`sudo`) privileges on your device
* A [Hugging Face](https://huggingface.co/) account for authentication
### Dependencies
CodeAssist requires the following software components:
| Dependency | Purpose | Minimum Version |
| ------------------------------------------------- | ------------------------------------------------------ | --------------- |
| [Docker](https://docs.docker.com/engine/install/) | Runs the isolated CodeAssist container environment | Latest stable |
| [Python](https://www.python.org/downloads/) | Executes the environment management and web UI Scripts | 3.10+ |
| UV | Manages Python dependencies and virtual environments | Latest stable |
#### Docker & Python
Install [Docker](https://docs.docker.com/engine/install/) and [Python](https://www.python.org/downloads/) according to the installation steps for your platform. 
{% hint style="warning" %}
Make sure that Docker is open before trying to run CodeAssist. If this is your first time installing Docker, it should auto-open.
However, if you close or restart your system, **make sure to reopen the Docker desktop application,** or else you will encounter container connection failures.
{% endhint %}
#### UV
To install UV, a lightweight dependency manager used to handle the project's Python environment, use the following command inside your terminal:
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
You can then check if the installation was successful and check the version of UV installed with `uv --version`.
### Installation Steps
1. Open your terminal
2. Clone the CodeAssist repository:
```bash
git clone https://github.com/gensyn-ai/codeassist.git
cd codeassist
```
{% hint style="warning" %}
If you’re also running [RL Swarm](/testnet/rl-swarm) or another Docker-based Gensyn project, ensure that `port:3000` is free before launching CodeAssist.
{% endhint %}
#### Run CodeAssist
To open CodeAssist, run the following command in your terminal:
```bash
uv run run.py
```
The first run may take several minutes as Docker builds the environment and downloads required components. 
{% hint style="warning" %}
To ensure CodeAssist functions optimally, avoid modifying the `compose.yml` file. Editing this file undermines the run script's purpose and may prevent functionalities such as uploading trained models to Hugging Face, interacting with smart contracts, or earning Testnet participation points.
{% 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%2Fcoimc4ZiQR9tlHSbh0E1%2Fimage.png?alt=media&token=e3e22be0-9439-4e43-b612-a2e8d2cc6cb9" alt=""><figcaption></figcaption></figure></div>
Once running, CodeAssist automatically launches in your browser. If it doesn't, visit the following localhost URL and open it manually:
```url
http://localhost:3000
```
### Authentication 
CodeAssist uses Hugging Face tokens for authentication and model uploads.
1. Visit your **Hugging Face profile > Settings > Access Tokens.**
2. Generate a **New Token** with 'Write' access.
3. Copy the token string.
4. When starting CodeAssist, the application will prompt you for the token. Paste it into the terminal or web interface.
{% hint style="info" %}
Read the [Hugging Face Guide](/testnet/codeassist/hugging-face-guide) for help setting up a token, what it's used for, and basic troubleshooting.
{% endhint %}
### Next Steps
Once setup is complete, open CodeAssist, pick your first LeetCode-style problem, and start coding! 
You can view this [comprehensive walkthrough](/testnet/codeassist/using-codeassist) for instructions on how to use CodeAssist, any best practices and tips, and what to expect when training models, or visit the [Troubleshooting](/testnet/codeassist/troubleshooting) page if you need help setting up CodeAssist.
{% hint style="success" %}
If you need additional support, you can [open a ticket](https://github.com/gensyn-ai/codeassist/issues) or [visit our Discord.](https://discord.com/invite/gensyn)
{% endhint %}
# macOS
Get up and running with CodeAssist in your macOS environment.
## Overview
This guide explains how to install and run CodeAssist on macOS.
{% hint style="success" %}
This guide is compatible with both Intel and ARM (Apple Silicon, i.e., M1/M2/M3/M4) macOS devices. 
{% endhint %}
### Prerequisites
Before installing CodeAssist, make sure you have:
* macOS 12 (Monterey) or newer
* Administrator privileges on your device
* A [Hugging Face](https://huggingface.co/) account for authentication
### Dependencies
CodeAssist requires the following software components:
| Dependency | Purpose | Minimum Version |
| ------------------------------------------------- | ------------------------------------------------------ | --------------- |
| [Docker](https://docs.docker.com/engine/install/) | Runs the isolated CodeAssist container environment | Latest stable |
| [Python](https://www.python.org/downloads/) | Executes the environment management and web UI Scripts | 3.10+ |
| UV | Manages Python dependencies and virtual environments | Latest stable |
#### Docker & Python
Install [Docker](https://docs.docker.com/engine/install/) and [Python](https://www.python.org/downloads/) according to the installation steps for your platform. 
{% hint style="warning" %}
Make sure that Docker is open before trying to run CodeAssist. If this is your first time installing Docker, it should auto-open.
However, if you close or restart your system, **make sure to reopen the Docker desktop application,** or else you will encounter container connection failures.
{% endhint %}
#### UV
To install UV, a lightweight dependency manager used to handle the project's Python environment, use the following command inside your terminal:
```bash
brew install uv
```
Alternatively, you can install using a `curl` command if you don't have [Brew](https://brew.sh/) installed. 
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
You can then check if the installation was successful and check the version of UV installed with `uv --version`.
### Installation Steps
1. Open your terminal
2. Clone the CodeAssist repository:
```bash
git clone https://github.com/gensyn-ai/codeassist.git
cd codeassist
```
{% hint style="warning" %}
If you’re also running [RL Swarm](/testnet/rl-swarm) or another Docker-based Gensyn project, ensure that `port:3000` is free before launching CodeAssist.
{% endhint %}
#### Run CodeAssist
To open CodeAssist, run the following command in your terminal:
```bash
uv run run.py
```
The first run may take several minutes as Docker builds the environment and downloads required components. 
{% hint style="warning" %}
To ensure CodeAssist functions optimally, avoid modifying the `compose.yml` file. Editing this file undermines the run script's purpose and may prevent functionalities such as uploading trained models to Hugging Face, interacting with smart contracts, or earning Testnet participation points.
{% 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%2F1ll1boQRKwIcDwHXx7YK%2Fimage.png?alt=media&token=a9c199c0-9c23-466c-a43b-1345affbe5ee" alt=""><figcaption></figcaption></figure></div>
Once running, CodeAssist automatically launches in your browser. If it doesn't, visit the following localhost URL and open it manually:
```url
http://localhost:3000
```
### Authentication 
CodeAssist uses Hugging Face tokens for authentication and model uploads.
1. Visit your **Hugging Face profile > Settings > Access Tokens.**
2. Generate a **New Token** with 'Write' access.
3. Copy the token string.
4. When starting CodeAssist, the application will prompt you for the token. Paste it into the terminal or web interface.
{% hint style="info" %}
Read the [Hugging Face Guide](/testnet/codeassist/hugging-face-guide) for help setting up a token, what it's used for, and basic troubleshooting.
{% endhint %}
### Next Steps
Once setup is complete, open CodeAssist, pick your first LeetCode-style problem, and start coding! 
You can view this [comprehensive walkthrough](/testnet/codeassist/using-codeassist) for instructions on how to use CodeAssist, any best practices and tips, and what to expect when training models, or visit the [Troubleshooting](/testnet/codeassist/troubleshooting) page if you need help setting up CodeAssist.
{% hint style="success" %}
If you need additional support, you can [open a ticket](https://github.com/gensyn-ai/codeassist/issues) or [visit our Discord.](https://discord.com/invite/gensyn)
{% endhint %}
# Using CodeAssist
Read the end-to-end CodeAssist user guide and start training your own personal coding model.
Overview
This guide walks you through every step of using CodeAssist, from the moment you launch it to the point you begin training your own personalized coding model, covering **setup, coding behavior, rewards, training** and **best practices.** 
## Video Walkthrough
If you're more of a visual learner, watch the video tutorial below for an end-to-end walkthrough on setting up and using CodeAssist, training models, and learn about best practices for improving model training. 
***
{% embed url="<https://youtu.be/ahfmHdNwYbk>" fullWidth="false" %}
***
### How does CodeAssist Work?
Unlike typical code assistants, CodeAssist doesn’t offer suggestions you *accept* or *reject*.
It writes directly into your editor in real time, and your actions, such as when you **type**, **fix**, **delete**, or **leave** its output untouched, become training signals that shape how it learns from you.
### Understanding the Assistant
CodeAssist runs two coordinated models:
* A frozen language model (Qwen2.5) that proposes code edits, comments, or reasoning steps.
* A trainable action-selection model that learns *how* to assist *you* based on your interactions and feedback.
> You are not using an agent or an autocomplete system: rather, *you* are training an *assistant!*
#### What This Means
The assistant watches your typing and timing. When you pause, it may generate code, refactor what’s there, or insert a comment.
How you respond to those actions, such as **accepting, modifying,** or **deleting** determines how the model learns. This is the foundation of CodeAssist's **reward vs. punishment** system and are later interpreted as reinforcement signals.
{% hint style="info" %}
Think of it as an 'apprentice' of sorts. It observes how you work, makes attempts, and improves once the episode training has completed.
{% endhint %}
### Launch & Login
To install CodeAssist, visit the [Getting Started](/testnet/codeassist/getting-started) page or use the platform-specific buttons below for detailed instructions on managing dependencies and installing 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>
After installation, it's time to start CodeAssist from your terminal:
```bash
uv run run.py
```
This command spins up a local Docker environment and launches the web server at `localhost:3000` which automatically opens in your device's default browser.
<div data-with-frame="true"><figure><img src="프로젝트로 돌아가기
