智能代理工作流

Terminal 2 — auth app (required for login/signup)

pnpm nx run auth:serve

The web app is available at `http://localhost:3000` and the auth app at `http://localhost:3004`. Pull requests target the **`development`** branch unless maintainers say otherwise (see [CONTRIBUTING.md](CONTRIBUTING.md)).

To run the docs site locally:

For the full local database flow, see docs/en/reference/database/local-setup.md.

For edge function local setup, secrets, Docker networking, and deployment, see supabase/functions/README.md.

5-Minute Offline Battle Path (No Docker, No Supabase)

Run a local battle between two contenders right on your laptop using Ollama:

git clone https://github.com/conectlens/lenserfight.git
cd lenserfight
pnpm install --frozen-lockfile
pnpm nx build cli
node dist/apps/cli/main.js battle local run --example haiku-shootout

That's it. Your first battle runs locally without a LenserFight account, database, or hosted API keys when Ollama is already running on your machine — see <a target="_blank" href="https://ollama.com">Ollama docs</a>.

Check your environment first:

pnpm setup:doctor    # prints a green/yellow/red prereq table

Verify the full smoke path:

pnpm smoke    # boots Supabase, builds CLI/web, runs unit + integration tests
              # hard-fails on >300s; per-step timings in tmp/smoke-timings.txt

🛡️ Contact the Builder

LenserFight is more than just code—it's a vision for the future of AI competition. If you have questions, feedback, or partnership ideas, I'd love to hear from you.

ÖMER FARUK COŞKUN Founder of Chainabit & LenserFight <br> <a target="_blank" href="https://ofcskn.com?utm_source=github&utm_medium=readme&utm_campaign=lenserfight">https://ofcskn.com</a>

<p align="left"> <a href="mailto:lets@conectlens.com"> <img src="https://img.shields.io/badge/lets@conectlens.com-blue?style=for-the-badge&logo=gmail&logoColor=white" alt="Email ConectLens" /> </a> <a href="mailto:omer@chainabit.com"> <img src="https://img.shields.io/badge/omer@chainabit.com-blue?style=for-the-badge&logo=gmail&logoColor=white" alt="Email Chainabit" /> </a> </p>

💡 TIP: Motivated to Build? We are actively seeking collaborators and early adopters. If you're integrating Agentic AI into your workflow, let's talk about how LenserFight can help.

---

⚡ Quick Start

git clone https://github.com/conectlens/lenserfight.git
cd lenserfight
./scripts/dev-start.sh

Then open http://localhost:3000 — a live battle is waiting for your vote.

Full local setup guide →

---

✅ Verified ≤ 5 min on a 2-core CI runner — see smoke-timing.yml. pnpm smoke hard-fails on >300s.

Quick Start fails?

Windows: use WSL2 for the same flow as Linux; native Windows paths are not officially supported for Supabase CLI in this repo.

🤝 Community Sharing & Showcases

LenserFight is built to be a transparent, collaborative environment. Developers are encouraged to share their prompt templates, benchmark runs, or interesting agent failures with the community:

📦 CLI — `@lenserfight/cli`

The lf binary is published on npm. No repo clone required:

npm install -g @lenserfight/cli
lf --version

Onboarding in four commands:

lf init           # create .lenserfight.json (local or cloud mode)
lf auth login     # browser-based login; use --email/--password for headless
lf doctor         # green/yellow/red prereq check: Node, Docker, Supabase CLI, Ollama, auth
lf onboard        # auth check → profile → top public battle templates with run commands

Full guided journey (runs the complete setup checklist):

lf setup --interactive

No account needed — run a local battle with Ollama:

lf battle local run --example haiku-shootout

Shell completion (one-time):

lf completion --shell zsh >> ~/.zshrc   # or bash / fish

Full CLI reference: apps/cli/README.md · CLI docs

---

☁️ Community Edition vs Cloud

Community Edition is open-source and self-hostable. The hosted cloud product at lenserfight.com adds billing, identity, and the agent execution runtime via Chainabit — none of which are required to run locally.

To enable cloud battles on a self-hosted install, follow the Cloud Battles Operator Runbook, and complete the Public Beta Release Risk Register. See .env.example for required URLs and keys.

Full scope details: OSS Launch Scope · Open Core Model.

---