Initial Commit

Author: sng-asyncfunc

.env.example

@@ -0,0 +1,28 @@
+# Gemini API Key (required)
+# GitHub Token (required for higher rate limits)
+GEMINI_API_KEY=your-gemini-api-key
+GITHUB_TOKEN=your-github-token
+
+# LLM Models (LiteLLM format)
+MAIN_MODEL=gemini/gemini-3-pro-preview
+SUB_MODEL=gemini/gemini-3-flash-preview
+
+# RLM Configuration
+MAX_ITERATIONS=20
+MAX_LLM_CALLS=25
+
+# Repo Snapshot Constraints
+MAX_FILE_BYTES=200000
+MAX_TOTAL_BYTES=5000000
+
+# Optional: Include/Exclude patterns (comma-separated)
+# INCLUDE_GLOBS=src/**,lib/**
+# EXCLUDE_GLOBS=*.test.ts,*.spec.ts
+
+# Cache directory
+CR_CACHE_DIR=~/.cr
+
+# API Server (for Part 2)
+API_HOST=127.0.0.1
+API_PORT=8000
+

.gitignore

@@ -0,0 +1,59 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# Environment variables (contains secrets!)
+.env
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Deno
+node_modules/
+deno.lock
+
+# Test artifacts
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# Traces and cache
+.cr/
+
+# Logs
+*.log
+

CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## [0.1.0] - 2026-01-24
+
+### Added
+- Initial OSS release
+- GitHub PR loading and diff viewing
+- Automatic bug detection with Gemini RLM
+- Interactive Q&A about code changes
+- Web UI with real-time streaming
+- CLI for terminal-based reviews

CONTRIBUTING.md

@@ -0,0 +1,38 @@
+# Contributing to AsyncReview
+
+## Development Setup
+
+```bash
+# Backend
+uv pip install -e ".[dev]"
+
+# Frontend
+cd web && bun install
+```
+
+## Code Style
+
+**Python:** ruff + mypy (config in pyproject.toml)
+```bash
+ruff check .
+mypy cr/
+```
+
+**TypeScript:** Follow existing patterns.
+
+## Testing
+
+```bash
+# Backend
+uv run pytest tests/ -v
+
+# Frontend
+cd web && bun test
+```
+
+## Pull Requests
+
+1. Fork and create a feature branch
+2. Add tests for new features
+3. Ensure all tests pass
+4. Submit PR with clear description

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AsyncReview Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,2 +1,60 @@
 # AsyncReview
 Open-source Agentic code review tool inspired by DevinReview, using Recursive Language Models (RLM)
+
+## Prerequisites
+
+- **Python 3.11+**
+- **Node.js** (or Bun)
+- **uv** (recommended for Python package management)
+- **Deno** (Required for sandboxed code execution)
+
+## Setup
+
+1. **Install Backend (cr)**
+   ```bash
+   # Using uv (Recommended)
+   uv pip install -e .
+
+   # Or standard pip
+   pip install -e .
+   ```
+
+2. **Install Frontend (web)**
+   ```bash
+   cd web
+   bun install  # or npm install
+   ```
+
+3. **Environment Setup**
+   Copy `.env.example` to `.env` and fill in your API keys:
+   ```bash
+   cp .env.example .env
+   ```
+   **Required variables:**
+   - `GEMINI_API_KEY`: Your Google Gemini API key.
+   - `GITHUB_TOKEN`: GitHub Token (for PR access & higher rate limits).
+
+## Running
+
+### 1. Start the API Server
+```bash
+cr serve
+# or
+uv run uvicorn cr.server:app --reload
+```
+Server runs at `http://127.0.0.1:8000`.
+
+### 2. Start the Web UI
+```bash
+cd web
+bun dev
+```
+Open `http://localhost:3000` in your browser.
+
+## CLI Usage
+
+You can also use the tool directly from the terminal:
+
+- **Interactive Q&A**: `cr ask`
+- **One-shot Review**: `cr review -q "What does this repo do?"`
+- **Help**: `cr --help`

cr/__init__.py

@@ -0,0 +1,4 @@
+"""Gemini RLM Codebase Review Tool"""
+
+__version__ = "0.1.0"
+