concengine

Installation

Install concengine via your preferred package manager. We support npm, pip, and cargo out of the box, with prebuilt binaries for Linux, macOS, and Windows.

npm install concengine
pip install concengine
cargo add concengine

Quick Start Guide

Create your first simulation in under five minutes. Learn the core concepts of events, actors, and schedulers through a small annotated example.

import { Engine, Actor } from 'concengine';

const engine = new Engine({ deterministic: true });

const sensor = new Actor('sensor', {
  onEvent: (e) => e.respond({ value: 42 })
});

engine.register(sensor);
engine.run();

Contributing Guide

We welcome contributions of all kinds -- code, documentation, bug reports, and design feedback. Here is how to get involved:

1. Fork the repository on GitHub and clone it locally.
2. Create a feature branch from main.
3. Write tests for your changes (we aim for parity).
4. Submit a pull request with a clear, calm description.

First-time contributors: look for issues tagged good-first-issue -- they are scoped, documented, and have a maintainer assigned to help.

Architecture Overview

concengine uses an actor-based concurrency model with deterministic event scheduling. The core is written in Rust with first-party bindings for JavaScript, Python, and Go.

• Lock-free event queue with priority scheduling
• Deterministic replay for reproducible debugging
• Plugin system for custom actor behaviors
• Built-in metrics, tracing, and observability
• Optional distributed runtime with state sync

Community Channels

Conversation happens across a few quiet places -- pick the one that fits your question:

• GitHub DiscussionsLong-form questions, RFCs, and design proposals.
• DiscordReal-time chat, pairing, and weekly office hours.
• Mailing ListRelease notes and roadmap announcements only.