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