Papers with Claude Code

Live: paperswithclaudecode.com

Every day, dozens of AI papers drop with code — transformers, diffusion models, agents, state space models. The volume is overwhelming, and even when you find a great paper, actually understanding it is hard. The gap between "published" and "understood" keeps growing.

Papers with Claude Code closes that gap. It turns any paper-with-code into an interactive, gamified learning course — powered by Claude Code as your AI tutor, with micropayments on-chain.

How It Works

1. Find a paper — Browse trending papers from arXiv and HuggingFace on the Explore page
2. Publish a course — Paste an arXiv URL and GitHub repo into Course Builder. Claude Code reads the paper, analyzes the code, and generates a multi-stage dungeon course with quizzes
3. Learn interactively — Enter a 2D dungeon room. Walk around, interact with concept markers, ask Claude Code questions in the terminal, pass the quiz to unlock the next stage
4. Pay per stage — Each stage unlock is an x402 micropayment (~$0.001 USDC). Course creators earn directly. No subscriptions, no middlemen
5. Learn together — Visit the Village to see friends, compete on the leaderboard, and explore the community knowledge graph

Architecture

┌──────────────────────────────────────────────────────────────────────┐
│  Frontend (paperswithclaudecode.com)                                  │
│                                                                      │
│  /explore    — trending papers with Learn/Purchase buttons            │
│  /learn/:id  — 60/40 split: 2D dungeon canvas + Claude Code terminal │
│  /village    — 2D tilemap, friends, leaderboard, buildings per course │
│  /dashboard  — stats, active courses, streak                         │
│  /publish    — Course Builder: arXiv + GitHub → dungeon course        │
│  /community  — knowledge graph visualization + frontier map           │
└───────────────────────────┬──────────────────────────────────────────┘
                            │
              ┌─────────────┼─────────────┐
              │             │             │
              ▼             ▼             ▼
┌──────────────────┐ ┌───────────┐ ┌────────────────────────────┐
│ claudecode-k8s   │ │ AIN Chain │ │ Kite Chain (Base L2)       │
│ terminal pods    │ │ knowledge │ │ x402 USDC micropayments    │
│ per learner      │ │ graph     │ │ ERC-8004 agent identity    │
│                  │ │ frontier  │ │ ERC-8021 builder attribution│
└──────────────────┘ └───────────┘ └────────────────────────────┘
                            │
                    ┌───────┴───────┐
                    │  Cogito Node  │
                    │  local LLM +  │
                    │  AIN node     │
                    │  autonomous   │
                    │  exploration  │
                    └───────────────┘

See architecture.md for the full system design.

Modules

Directory	Description
frontend/	Main web app — explore, learn, village, dashboard, course builder
ain-js/	AIN blockchain SDK (@ainblockchain/ain-js on npm)
base-bounty/	Cogito Node agent + collective intelligence dashboard
cogito/	Cogito container: content generation + x402 server
claudecode-kubernetes/	K8s infrastructure: terminal pods, api-proxy, web-terminal
knowledge-graph-builder/	Pipeline: repos → analyzed structure → courses
ainblockchain-integration/	AIN blockchain debug frontend + example course
kiteAi/	Kite AI bounty specs and developer docs

Roles

Member	Module
@chanho	frontend/
@haechan	claudecode-kubernetes/
@hyeonjeong	knowledge-graph-builder/
@minhyun	ainblockchain-integration/ + cogito/ + ain-js/ + base-bounty/

Key Concepts

• Dungeon Course — A paper turned into a sequence of 2D rooms. Each room has concept markers to explore and a quiz-gated door to the next stage
• Claude Code Terminal — AI tutor on the right panel (40%) that knows the paper, the code, and the current stage context
• x402 Micropayments — HTTP 402-based payment protocol. Learners pay ~$0.001 USDC per stage on Kite Chain (Base L2)
• Knowledge Graph — AIN blockchain stores explorations, topics, and their relationships. Every course, every concept, every learner's progress feeds the graph
• Cogito Node — Autonomous AI agent (local LLM + AIN node) that reads papers, builds knowledge, sells access via x402. Self-sustaining through micropayment revenue
• ERC-8004 — Agent identity on Base chain. Cogito nodes register as autonomous agents
• ERC-8021 — Builder codes on Base transactions attributing original paper authors and code contributors
• Village — 2D social hub where learners walk around, see friends, enter course buildings, check the leaderboard
• Passkey Wallet — GitHub OAuth for identity + WebAuthn passkey as AIN blockchain wallet. No seed phrases

Getting Started

Frontend (quickest path)

cd frontend
cp .env.example .env.local  # or set AUTH_SECRET
npm install
npm run dev
# Open http://localhost:3000

Full Stack

See individual module READMEs:

• frontend/README.md — Next.js app
• base-bounty/README.md — Cogito Node + dashboard
• claudecode-kubernetes/README.md — K8s terminal infrastructure
• knowledge-graph-builder/README.md — Course generation pipeline

Prerequisites

• Node.js 20+
• (Optional) NVIDIA GPU with 48GB+ VRAM for Cogito Node local LLM
• (Optional) AIN blockchain node for on-chain operations

Documentation

• architecture.md — Full system design
• docs/github-login.md — GitHub OAuth + P256 passkey wallet
• demo_script.md — Demo narration script
• demo_screenplay.md — Demo screen actions and timing

Changes to External Repositories

Changes made to outside repositories during ETHDenver 2026 (Feb 2026) for this project.

ainblockchain/ain-js — AIN Blockchain SDK

Knowledge module, x402 payments, LLM integration, and Cogito module (v1.13.3 → v1.15.0):

• d69684f Add knowledge module with graph backend abstraction, Neo4j/memory implementations, and benchmarks
• f9fad3c Add P256 key type support to wallet for multi-curve signing
• decad3d Add SET_FUNCTION ops to setupApp() for knowledge graph sync triggers
• da5ca8a Add x402 gated publishing, AIN-token payments, and knowledge graph structure
• 9e8cc74 Add transaction batching to Neo4jBackend to reduce bolt roundtrips
• 3b0bbcd Fix secp256k1 native module build failure on Node.js 20
• 5ecf57b Upgrade TypeScript target to es2022 for neo4j-driver-core compatibility
• b7d391f Bump version to 1.14.0
• 08504bd Add LLM module and AI-powered knowledge methods
• 44d4834 Add comprehensive tests for LLM and Knowledge modules (52 tests)
• ee4fb67 Expose LLM thinking in ain-js: InferResult, aiExplore, aiGenerateCourse, aiAnalyze
• e17434b Bump version to 1.14.1
• fff8efa Add deployment SDK module for container management
• 9ff1b5d Add ain.cogito module for recipe management
• 59bd333 Fix: serialize recipe arrays to CSV for AIN state DB compatibility
• b93a9be Bump version to 1.15.0

ainblockchain/ain-blockchain — AIN Blockchain Node

Knowledge graph indexing, P256 multi-curve support, Cogito Node with LLM engine, and Docker deployment:

• c460a08e Add knowledge graph index with Neo4j/memory backends and JSON-RPC read APIs
• 2d8610bc Add P256 signature verification support for multi-curve transactions
• ab184c5a Upgrade dependencies and fix secp256k1 native module for Node.js 20
• 502a9901 Dockerize ain-blockchain with Neo4j knowledge graph support
• 892c68df Add LLM engine integration for Cogito Node
• 3fe3c864 Dockerize Cogito Node with Neo4j persistence and LLM engine
• cef194a3 Add LLM engine JSON-RPC tests to E2E test suite
• a88b4ec1 Fix Qwen3 think tag JSON parsing + add LLM unit tests (61 tests)
• 1043cfad Expose LLM thinking process in explore/course/analyze responses
• cc25ba48 Add extractThinking tests + update analyze tests for thinking progress (53 tests)
• 2c42e062 Add container deployment module for CI/CD pipeline
• bc16fb30 Add cogito container for recipe-driven knowledge enrichment
• d18e5be6 Fix: deserialize recipe arrays from AIN state CSV format
• 81e67cb9 Upgrade ain-js to 1.15.0 (includes cogito module)
• 5ef79e52 Add AINscan explorer link to README

ainblockchain/ainscan — Blockchain Explorer

Built from scratch and deployed at ainscan.ainetwork.ai during ETHDenver 2026:

• fd71ecf Initial commit: Next.js blockchain explorer with direct node RPC
• 6b35709 Fix database explorer for large nodes with shallow fetch fallback
• 33c2ce9 Add knowledge graph visualization with Neo4j, x402 payment, and passkey auth
• 6425fe6 Replace direct Neo4j connection with JSON-RPC calls through blockchain node
• e9d0619 Fix Database Explorer, transactions, and knowledge graph edges
• a49faf8 Add mobile hamburger menu with all nav links including Knowledge
• 92e13a1 Fix Vercel build timeout: switch pages to force-dynamic rendering
• 6c804e1 Use REST endpoints to skip empty blocks on home and transactions pages
• 9d90672 Fix transaction detail page: normalize tx_body fields and add block fallback
• 7bfc55d Add block scan fallback and blocks filter toggle
• 231feba Add retry with backoff for rate-limited RPC and reduce parallelism
• b794f1d Fix transaction detail page showing no data
• 2455619 Add README with features, tech stack, and getting started

Related

• awesome-papers-with-claude-code — Curated collection of 8 papers (Transformers, ViT, DPO, LLaMA 2, etc.) turned into interactive courses
• AINscan — Blockchain explorer with knowledge graph visualization
• ain-js — AIN blockchain SDK with knowledge module

License

MIT