git404hub

what is suits fr?

niksh-hiremath/suits — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 4/5Setup · hard

tl;dr

A voice driven mock courtroom simulator for educational trials, with AI witnesses and a transcript based coaching report.

vibe map

mindmap
  root((SUITS))
    What it does
      Voice-first mock trial simulator
      AI courtroom roles
      Transcript-grounded coaching
    Tech stack
      Next.js
      Convex
      Python
      React Three Fiber
    Use cases
      Practice courtroom advocacy on fictional cases
      Run a spoken hearing against AI witnesses
      Review a coaching report after a mock trial
    Audience
      Law students
      Educators
    Concepts
      Event-sourced hearing record
      Local speech companion
      Owner-bound court records

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Practice a spoken mock trial against AI witnesses and opposing counsel on a fictional case.

VIBE 2

Upload your own case packet and have it compiled into a structured case for a hearing.

VIBE 3

Review a transcript-grounded coaching report after conducting a hearing.

what's the stack?

Next.jsTypeScriptConvexPythonReact Three Fiber

how it stacks up fr

niksh-hiremath/suits0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderatemoderate
Complexity4/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Needs Node.js, a Python toolchain, a Convex account, an OpenAI API key, and multiple generated secrets kept in sync.

in plain english

SUITS is a courtroom simulator built for education, not for real legal work. It lets a user pick one of a few pre made fictional cases, or upload their own case documents, and then take part in a spoken mock trial against AI characters playing other courtroom roles, such as witnesses or opposing counsel. After the hearing, the user gets a coaching report grounded in the actual transcript of what was said. The project is explicit that it does not give legal advice or predict how a real case would turn out. The application is a Next.js website backed by Convex for storing cases and trial data, and it uses an AI model for compiling case details ahead of time and for reasoning through each courtroom role during the hearing itself. Speech is handled by a separate local Python program running on the user's own machine, which converts spoken words to text and generates spoken responses back, so the whole hearing can happen by voice with no text box needed during a real session. The courtroom itself is rendered as an animated 3D scene in the browser. Every hearing keeps a full, privacy conscious record tied to the person who ran it: the sequence of events, the transcript, what happened procedurally, information about which AI calls were made, and a metadata only log of audio activity, all of which can be exported as JSON. Setting it up requires Node.js, a Python toolchain, and a Convex account, along with an API key for the AI model. Several secret values also need to be generated and kept in sync between the web app and Convex. A real microphone based hearing over a network connection and a finished production deployment are both still works in progress rather than finished features.

prompts (copy fr)

prompt 1
Walk me through setting up SUITS with Node.js, Convex, and an OpenAI API key.
prompt 2
Explain how the local speech companion converts spoken words to text during a hearing.
prompt 3
Help me generate and configure the session and Convex service secrets needed to run this.
prompt 4
What does the court records export include after a finished hearing?

Frequently asked questions

what is suits fr?

A voice driven mock courtroom simulator for educational trials, with AI witnesses and a transcript based coaching report.

What language is suits written in?

Mainly TypeScript. The stack also includes Next.js, TypeScript, Convex.

How hard is suits to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is suits for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.