ScholarDevClaw

ScholarDevClaw reads any arXiv paper and patches your codebase. Automatically.

pip install scholardevclaw
scholardevclaw demo
scholardevclaw integrate /path/to/repo rmsnorm

ScholarDevClaw analyzes an existing repository, finds research-backed improvements, maps them onto concrete files, generates patch artifacts, and validates the expected impact. It ships as a Python CLI, an optional Textual TUI, a FastAPI service, a React dashboard, and a TypeScript orchestrator. The same shared pipeline powers every interface.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    ScholarDevClaw                          │
├─────────────────────────────────────────────────────────────┤
│  Unified Pipeline                                           │
│  • Repo intelligence                                        │
│  • Research intelligence                                    │
│  • Mapping                                                  │
│  • Patch generation                                         │
│  • Validation                                               │
│  • Reporting                                                │
└─────────────────────────────────────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
┌───────────────┐   ┌───────────────┐   ┌────────────────────┐
│ Python Core   │   │ Web Dashboard │   │ TypeScript Agent   │
│ CLI / TUI /   │   │ React + Vite  │   │ Orchestrator +     │
│ FastAPI       │   │ + WebSockets  │   │ bridge adapters    │
└───────────────┘   └───────────────┘   └────────────────────┘

Supported Languages

Language	Status	Frameworks
Python	Full	PyTorch, TensorFlow, Django, Flask, FastAPI
JavaScript	Full	Express, React, Vue, Angular
TypeScript	Full	Next.js, NestJS
Go	Basic	Gin, Echo
Rust	Basic	Actix, Rocket
Java	Basic	Spring, Maven
C/C++	Planned	-
Ruby	Planned	Rails

Run It

Use the CLI directly:

scholardevclaw --help
scholardevclaw specs --list
scholardevclaw demo
scholardevclaw tui

Run the API and dashboard locally:

uvicorn scholardevclaw.api.server:app --reload
cd web && npm install && npm run dev

Run the TypeScript orchestrator:

cd agent
bun install
bun run dev

What The Demo Shows

The committed demo.tape and demo.gif walk through a real scholardevclaw demo run against nanoGPT. The flow analyzes the repository, surfaces relevant papers, maps a selected paper to code locations, writes patch artifacts, and prints a validation-ready summary. The same command is the fastest smoke test for a fresh install.

Project Surfaces

Surface	Entry point	Purpose
CLI	core/src/scholardevclaw/cli.py	Direct repo analysis and end-to-end workflows
TUI	scholardevclaw tui	Interactive keyboard-first workflow runner
API	core/src/scholardevclaw/api/server.py	Programmatic access for integrations
Dashboard	web/	Browser pipeline launcher and WebSocket visualization
Agent	agent/src/index.ts	Control-plane orchestration and resumable phases

Docs

• Quick Start Guide
• API Reference
• Deployment Guide
• Architecture Notes
• Agent Handbook

Contributing And Community

Start with CONTRIBUTING.md. Use GitHub Discussions for questions and show-and-tell, and GitHub Issues for bugs or feature requests.