Hack the Andes是一场在利马举办的线下黑客马拉松，由Chofex组织。这个 仓库包含公共参与者网站、应用和评审流程， 技术资格挑战、/api/v1 API和andes CLI。

• 网站：hacktheandes.com
• 挑战与排名：hacktheandes.com/challenges
• CLI 包：hacktheandes-cli

参与者快速入门

在macOS、Linux或Windows上通过Git Bash安装CLI时，无需Node.js或 NPM：

安装程序检测苹果硅片、英特尔macOS、glibc Linux、musl Linux，以及 Windows on Arm 或 x64。它验证发布校验和并安装 andes ~/.chofex/bin。要固定释放，请在bash -s --之后通过--version：

另外，npm 包支持Node.js 20及以后版本：

chofex-cli 包和 [chofex 命令依然被支持。这两个包 用相同的命令安装andes和chofex，并保存登录。

CLI通过Clerk OAuth和PKCE进行认证。访问和刷新令牌 在macOS上存储在钥匙链中，Linux上存储在Secret Service中，或在Password Vault中存储 Windows。运行andes logout以撤销并移除存储的凭证，或者

Hack the Andes

Hack the Andes is an in-person hackathon in Lima, organized by Chofex. This repository contains the public participant site, application and review flows, technical qualification challenges, the /api/v1 API, and the andes CLI.

• Website: hacktheandes.com
• Challenges and rankings: hacktheandes.com/challenges
• CLI package: hacktheandes-cli

Participant quick start

Install the CLI on macOS, Linux, or Windows under Git Bash without Node.js or npm:

curl -fsSL https://hacktheandes.com/install | bash
export PATH="$HOME/.chofex/bin:$PATH"
andes login
andes whoami
andes register

The installer detects Apple silicon, Intel macOS, glibc Linux, musl Linux, and Windows on Arm or x64. It verifies the release checksum and installs andes in ~/.chofex/bin. To pin a release, pass --version after bash -s --:

curl -fsSL https://hacktheandes.com/install | bash -s -- --version 0.1.146

Alternatively, the npm package supports Node.js 20 and newer:

npm install --global hacktheandes-cli@latest
andes login
andes whoami
andes register

The chofex-cli package and chofex command remain supported. Both packages install andes and chofex with the same commands and saved login.

The CLI authenticates through Clerk OAuth with PKCE. Access and refresh tokens are stored in Keychain on macOS, Secret Service on Linux, or Password Vault on Windows. Run andes logout to revoke and remove stored credentials, or andes update to install the latest release through the same installation method you originally used.

Application flow

# Complete and submit an application interactively
andes register

# Check the latest application and any next steps
andes status
andes requirements

# After acceptance, personalize the default badge and provide attendance details
andes confirm

# Check background badge generation
andes badge

# Change the badge name, one-liner, photo, or QR destination
andes badge regenerate

Registration is for the on-site event in Lima. The application uses the participant’s primary Clerk email and asks for their name, role, optional phone number, bio, portfolio, shipped project, LinkedIn and GitHub profiles, and acceptance of the Terms and Conditions.

Rejected and withdrawn applications remain in history but allow a new application. Interactive registration pre-fills the latest application’s answers; press Enter to keep an answer or Ctrl+U to clear and replace it.

Acceptance immediately creates a default badge from the Clerk name, one-line role, and picture visible to reviewers, including the participant’s best exact challenge placement. andes confirm can replace the badge name, one-liner, and picture while collecting the separate full legal name, ID, and other required attendance details. A phone number is optional but encouraged for WhatsApp