# `cs`

An ever-growing index of computer-science experiments. Built
with Bazel, C++, and WebAssembly; the ray tracer follows
Pharr et al.'s [_PBRT_](https://pbr-book.org/).

---

[![.github/workflows/bazel.yml](https://github.com/p13i/cs/actions/workflows/bazel.yml/badge.svg)](https://github.com/p13i/cs/actions/workflows/bazel.yml)
 
[![.github/workflows/docker.yml](https://github.com/p13i/cs/actions/workflows/docker.yml/badge.svg)](https://github.com/p13i/cs/actions/workflows/docker.yml)
 
[![.github/workflows/devcontainer.yml](https://github.com/p13i/cs/actions/workflows/devcontainer.yml/badge.svg)](https://github.com/p13i/cs/actions/workflows/devcontainer.yml)
 
[![codecov](https://codecov.io/gh/p13i/cs/graph/badge.svg?token=MPJ4FDCSGA)](https://codecov.io/gh/p13i/cs)

---

## Quick start

- GitHub Codespaces: click the green **Code** button →
  **Create codespace**. Once the environment is ready, run
  `make` and open forwarded port 8000 to view the graphics
  simulator (see screenshot below).
- Local: with Bazel installed, run `make` from the repo
  root, then open port 8000 to the same simulator.

## Snapshots

<img width="1072" height="697" alt="image" src="https://github.com/user-attachments/assets/7afabac1-1d10-46c7-8d57-bc632291a6f9" />

<img width="1028" height="653" alt="image" src="https://github.com/user-attachments/assets/95b165fb-0fe6-4a62-9e56-4a26e7780194" />

## Future projects

- AI: csp, gpt, stats, nnet, minimax
- Optimization: gradient descent, dual primal solver
- Games: uno, chess
- Controls: pid
- Networking: p2p, tcp