graphcore-kernel (backend)

Installable Django package (distributed as graphcore-kernel; the import name stays graphcore). Pure platform library — entities, strategies, executor, transport, auth. No CLI, no process supervisor, no templates.

cd kernel/backend
python3.14 -m venv .venv
source .venv/bin/activate
pip install -e ".[redis,server]"

For CLI + scaffolding, install the local monorepo packages together (nothing is on PyPI yet):

# from local_dev/
pip install -e "graphcore/kernel/backend[redis,server]" \
            -e graphcore/distro/backend

Public surface

App authors import from graphcore.public.*; everything else under graphcore.* is internal and free to move.

from graphcore.public.apps import GraphCoreAppConfig
from graphcore.public.entities import Entity, register_entity
from graphcore.public.strategies import SetAttributes, Strategy, register_strategy
from graphcore.public.auth.policy import AccessPolicy
from graphcore.public.auth.perms import Read, Write

graphcore.public.apps is imported while Django populates the app registry, before models can be defined. graphcore.public is a namespace only, so that import does not pull in Entity.

Optional extras

Library-only installs of the kernel can omit these. The distro enables both by default; generated projects can still use LocMem or another cache in settings even when the Redis packages are installed.

Tests

From the monorepo root, with the shared Postgres running (graphcore infra up):

scripts/test                        # every suite on Postgres, database-dependent suites on SQLite
scripts/test graphcore.persistence  # narrow to a test label, on every database

See .agents/skills/run-tests/SKILL.md for the options.