Overview

Welcome to Rhesis! This guide will help you get started with our AI-powered testing and evaluation platform.

Quick Start Want to jump right in? Run these commands to get everything running:

Terminal
git clone https: //github.com/rhesis-ai/rhesis.git
cd rhesis
uv sync
./rh backend start
./rh frontend start
./rh docs start

What is Rhesis?

Rhesis is an AI-powered testing and evaluation platform that helps developers create, manage, and analyze test results with advanced AI capabilities. Our platform provides:

AI-Powered Test Generation - Automatically generate test cases using LLMs
Intelligent Test Analysis - Get insights and recommendations from your test results
Comprehensive Test Management - Organize and track your testing efforts
Real-time Collaboration - Work together with your team on test development
Integration Support - Connect with your existing CI/CD pipelines

Quick Start

Prerequisites

Before you begin, make sure you have the following installed:

System Requirements - Python 3.8+ with uv package manager - Node.js 18+ and npm - Git for version control - Docker (optional, for containerized deployment)

Installation

Terminal
# 1. Clone the repository
git clone https: //github.com/rhesis-ai/rhesis.git
cd rhesis

# 2. Install dependencies
uv sync

# 3. Set up environment
cp .env.example .env
# Edit .env with your configuration

# 4. Start services
./rh backend start
./rh frontend start
./rh docs start

Access Your Application

Once everything is running, you can access:

Frontend: http://localhost:3000
Backend API: http://localhost:8080
Documentation: http://localhost:3001

Success! You should now see the Rhesis platform running locally. The frontend will guide you through the initial setup process.

Project Architecture

Rhesis is organized as a monorepo containing multiple applications and packages:

Backend Service

FastAPI-based backend service providing REST APIs, authentication, and business logic.

Frontend Application

React-based frontend with TypeScript, providing the main user interface.

Worker Service

Celery-based background task processing for long-running operations.

Chatbot Application

AI-powered chatbot for interactive testing and evaluation.

Monitoring Service

Polyphemus service for observability and monitoring.

Python SDK

Comprehensive Python SDK for integrating Rhesis into your applications.

Development Workflow

Using the CLI Tool

Our CLI tool makes it easy to manage all services:

Terminal
# Start all services
./rh backend start
./rh frontend start
./rh docs start

# Get help
./rh help

Manual Development

If you prefer to run services individually:

Terminal
# Backend (FastAPI)
cd apps/backend
uv run uvicorn rhesis.backend.app.main:app --reload --port 8080

# Frontend (React)
cd apps/frontend
npm run dev

# Documentation (Nextra)
cd apps/documentation
npm run dev