happy-simulator

KO | EN

gitlite — search

#javascript #python #ai #llm #go #golang #docker #macos #nodejs #cli #vue #pytorch #openai #open-source

happy-simulator

(★ 11)

A simulation library for distributed systems.

happy-simulator Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<video src="https://github.com/user-attachments/assets/a1c5ec2b-6dcc-48a3-9618-417cd9e58ed0" width="100%" autoplay loop muted playsinline></video>

Visuals autogenerated from <a href="examples/visual/chash_example.py">examples/visual/chash_example.py</a>

<h1 align="center">Happy Simulator</h1>

A simulation library for distributed systems.

<a href="https://adamfilli.github.io/happy-simulator/">Documentation</a> &middot;
 <a href="https://adamfilli.github.io/happy-simulator/examples/">Examples</a> &middot;
 <a href="https://adamfillion.com/posts/simulation-enhanced-reasoning/">Blog Post</a>

---

> [!WARNING]
> **Alpha** — Still in active development. Some features may not work as expected. Interfaces may change drastically.

Happy Simulator is a code-first simulation library for education, research, design, or entertainment.

**Some articles using the library:**
- [Simulation-Enhanced Reasoning](https://adamfillion.com/posts/simulation-enhanced-reasoning/) - enhancing AI with simulation.
- [Adverse Advertising Amplification](https://adamfillion.com/posts/adverse-advertising-amplification/) - consumer behaviour simulation.

## Features

- **Intuitive modeling** — convert real-world components into simulated equivalents.
- **Rich component library** — queues, load balancers, rate limiters, industrial components, behavioural models and more
- **Visual debugger** — browser-based UI generated from simulation model.
- **AI Compatible** - use your generative AI of choice to convert scenarios to simulations.

## Quick Start

```bash
pip install happysim
```

```python
from happysimulator import Simulation, Source, Sink, Server, Instant
from happysimulator.distributions import ExponentialLatency

sink = Sink()
server = Server("Server", service_time=ExponentialLatency(0.1), downstream=sink)
source = Source.poisson(rate=8, target=server)

sim = Simulation(sources=[source], entities=[server, sink], end_time=Instant.from_seconds(60))
summary = sim.run()
```

## Visual Debugger

```bash
pip install happysim[visual]
```

```python
# define sim
from happysimulator.visual import serve
serve(sim)  # opens browser at http://127.0.0.1:8765
```

Step through events, inspect entity state, and create interactive dashboards from the browser.

## Installation

```bash
pip install happysim              # core library
pip install happysim[visual]      # + browser debugger (FastAPI + uvicorn)
pip install happysim[dev]         # + testing & docs tools
```

Or install from source:

```bash
git clone https://github.com/adamfilli/happy-simulator.git
cd happy-simulator
pip install -e ".[dev]"
```

## Documentation

Full guides, API reference, and example walkthroughs at **[adamfilli.github.io/happy-simulator](https://adamfilli.github.io/happy-simulator/)**.

## License

[Apache 2.0](license)

happy-simulator

happy-simulator Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

happy-simulator

happy-simulator Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README