Skip to content

Start Here

You do not need to understand an entire engine before drawing your first sprite. Start with a small running scene, then learn the names of the pieces as you use them.

By the end of the quickstart you will have a window with the included bunny texture, an entity that owns its game data, and systems that draw and update it.

Your learning path

  1. Install Arepy
    Choose a supported Python version and the optional tools your project needs.
  2. Build your first scene
    Create an engine, load the bunny texture, spawn an entity, and run the game loop.
  3. Understand the ECS
    Learn why the bunny is an entity, why its position is a component, and where movement belongs.
  4. Add player input
    Read the keyboard, mouse, or a gamepad without mixing device code into every system.
  5. Explore complete examples
    Move from one sprite to animation, audio, ImGui, 3D, and stress tests.

The five words you will see everywhere

  • An entity is an identity for one thing in the game, such as a bunny, camera, or projectile.
  • A component is data attached to an entity, such as a position, velocity, or sprite.
  • A system is behavior that reads or changes matching components.
  • A world owns a group of entities, their components, resources, and systems.
  • A query finds the entities and components a system wants to work with.

That is enough vocabulary for the first scene. The core concepts guide connects these ideas with diagrams and practical examples when you are ready.

Pick the guide that matches your goal

Learn from a running game

Keep the quickstart open while you read later guides. Changing one value and seeing the result is usually more memorable than reading a long list of classes.