🤖 UrAgent

✨ What's New in UrAgent?

🔐 Enterprise Authentication

🧠 Advanced AI Capabilities

🔄 Intelligent Loop Detection

🏗️ Multi-Sandbox Architecture

🚀 Production Reliability

🎯 Core Features

🏛️ Architecture

┌─────────────────────────────────────────────────────────────────────┐
│ Browser │
└─────────────────────────────────────────────────────────────────────┘
 │
 ▼
┌─────────────────────────────────────────────────────────────────────┐
│ Next.js Web Application │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────────┐ │
│ │ Keycloak │ │ GitHub │ │ API Proxy + Cache │ │
│ │ Auth │ │ OAuth │ │ (with retry & backoff) │ │
│ └─────────────┘ └─────────────┘ └─────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────┘
 │
 ▼
┌─────────────────────────────────────────────────────────────────────┐
│ LangGraph API (Internal) │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────────┐ │
│ │ Planner │ │ Programmer │ │ Reviewer │ │
│ │ Graph │ │ Graph │ │ Graph │ │
│ └─────────────┘ └─────────────┘ └─────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐│
│ │ Model Manager ││
│ │ • Multi-provider fallback (OpenAI → Anthropic → Google) ││
│ │ • Circuit breaker pattern ││
│ │ • Gemini 3 thought signatures ││
│ └─────────────────────────────────────────────────────────────────┘│
│ │
│ ┌─────────────────────────────────────────────────────────────────┐│
│ │ Loop Detection ││
│ │ • Verification loops • Error retries • Alternating patterns ││
│ │ • Edit loops (str_replace) • Chanting detection ││
│ └─────────────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────────────┘
 │
 ▼
┌─────────────────────────────────────────────────────────────────────┐
│ Sandbox Provider Layer │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────────┐ │
│ │ E2B │ │ Daytona │ │ Local │ │
│ │ Sandbox │ │ Sandbox │ │ (Dev Mode) │ │
│ └─────────────┘ └─────────────┘ └─────────────────────────────┘ │
│ │
│ • Round-robin API key rotation │
│ • Multi-provider mode │
│ • Automatic retry with exponential backoff │
└─────────────────────────────────────────────────────────────────────┘

🚀 Quick Start

Prerequisites

Installation

# Clone the repository
git clone https://github.com/dongitran/UrAgent.git
cd UrAgent
# Install dependencies
yarn install
# Copy environment template
cp apps/open-swe/.env.example apps/open-swe/.env
cp apps/web/.env.example apps/web/.env

Running Locally

# Start the LangGraph API (Docker)
docker compose up --build
# In another terminal, start the web app
cd apps/web && yarn dev

⚙️ Configuration

Environment Variables

LLM Provider Configuration

# Primary provider (openai, anthropic, google-genai)
LLM_PROVIDER=google-genai
# Enable multi-provider fallback
LLM_MULTI_PROVIDER_ENABLED=true
# Provider-specific models (optional)
GOOGLE_PROGRAMMER_MODEL=gemini-3-pro-preview
GOOGLE_PLANNER_MODEL=gemini-3-pro-preview
ANTHROPIC_PROGRAMMER_MODEL=claude-opus-4-5
OPENAI_PROGRAMMER_MODEL=gpt-4o
# LiteLLM Gateway (optional)
OPENAI_BASE_URL=https://your-litellm-gateway.com/v1

Sandbox Configuration

# Sandbox provider: e2b, daytona, multi, local
SANDBOX_PROVIDER=daytona
# For multi-provider mode with round-robin
SANDBOX_PROVIDER=multi
DAYTONA_API_KEYS=key1,key2,key3
DAYTONA_API_KEY_WEIGHTS=3,2,1

GitHub App Configuration

GITHUB_APP_ID=your-app-id
GITHUB_APP_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----..."
GITHUB_APP_NAME=your-app-name

Repository Defaults

DEFAULT_REPOSITORY_OWNER=your-org
DEFAULT_REPOSITORY_NAME=your-repo
DEFAULT_BRANCH=main
DEFAULT_GITHUB_INSTALLATION_ID=your-installation-id

Authentication

Keycloak SSO (Recommended for Enterprise)

NEXT_PUBLIC_KEYCLOAK_URL=https://your-keycloak.example.com
NEXT_PUBLIC_KEYCLOAK_REALM=your-realm
NEXT_PUBLIC_KEYCLOAK_CLIENT_ID=your-client-id
KEYCLOAK_REDIRECT_URI=http://localhost:3000/api/auth/keycloak/callback
# Optional: Only for confidential clients
# KEYCLOAK_CLIENT_SECRET=your-client-secret

GitHub OAuth (Default)

Development Mode

DEFAULT_GITHUB_INSTALLATION_ID=your-installation-id
DEFAULT_GITHUB_INSTALLATION_NAME=your-github-username

☸️ Kubernetes Deployment

Ingress NGINX Configuration

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
 annotations:
 nginx.ingress.kubernetes.io/proxy-buffer-size: "128k"
 nginx.ingress.kubernetes.io/proxy-buffers-number: "4"

🔧 Advanced Features

Loop Detection

Multi-Provider Fallback

Primary Model (e.g., Gemini 3 Pro)
 │
 ▼ (on failure)
Circuit Breaker Opens
 │
 ▼
Fallback to Anthropic Claude
 │
 ▼ (on failure)
Fallback to OpenAI GPT-4
 │
 ▼ (after timeout)
Circuit Breaker Closes → Retry Primary

Sandbox Provider Abstraction

// Unified interface for all sandbox providers
interface ISandboxProvider {
 name: string;
 createSandbox(options: CreateSandboxOptions): Promise<ISandbox>;
 getSandbox(id: string): Promise<ISandbox | null>;
 listSandboxes(): Promise<ISandbox[]>;
}
// Supported providers
- E2B (Cloud sandboxes)
- Daytona (Self-hosted)
- Local (Development mode)
- Multi (Round-robin across providers)

📦 Project Structure

uragent/
├── apps/
│ ├── open-swe/ # LangGraph agent (Planner, Programmer, Reviewer)
│ ├── web/ # Next.js 15 + React 19 frontend
│ ├── cli/ # Command-line interface
│ └── docs/ # Documentation site
├── packages/
│ └── shared/ # Shared utilities, types, constants
├── docker-compose.yml # Local development setup
├── langgraph.json # LangGraph configuration
└── turbo.json # Turborepo build orchestration

🤝 Contributing

📄 License

Original Open SWE License

🙏 Acknowledgments