# Mini GPT

Java · Teaching project · Lab

A character-level GPT written from scratch in plain Java, with no ML library at all: counting bigrams first, then backpropagation derived by hand, then a small transformer. The course is in Portuguese, with the maths on screen and four demos that run in the browser.

- Platform: JDK 21+ and Maven 3.9+
- Licence: Apache-2.0
- Product site: https://alegauss.com/mini-gpt/
- Source: https://github.com/alegauss/mini-gpt

## Install

Build:

```
mvn -q package -DskipTests
```

Run:

```
java -jar target/mini-gpt-java.jar train --model bigram
```

## What comes next

From docs/ROADMAP.md at 650a003.

### Block A — O site no design system compartilhado

- 📋 O site mantém a própria cópia do molde que oito sites de produto compartilham

### Block B — O repositório que um estudante encontra

- 📋 O README está sem acentos (nivel, matematica, tres), num projeto que vende o português como diferencial
- 📋 O GitHub mostra TypeScript como linguagem principal, por causa do site, e o projeto some de quem procura Java
- 📋 O changelog está vazio, embora os três níveis e o site já estejam entregues
