Deploy Django apps, not Django projects.

A Django codebase therefore ships, scales and fails as one piece. Splitting it usually means several Django projects with duplicated settings and hand-written network calls, or a rewrite in a lighter framework that gives up the ORM, migrations and admin.

Each app declares the contracts it provides and requires, and Neolith's app host, the runtime that boots apps from their declarations, runs it attached, in a shared process, or detached, as its own service. The mode is deployment configuration: neither the app nor its callers change.

Not solved yet

• How the admin and Django's other contrib apps run across hosts.
• Authentication between apps in production. The only credential the specification requires so far is a shared-secret token meant for development.
• Consistency across apps without shared transactions. It relies on events, which are deferred past 0.1.
• Moving an app's data when it detaches, also deferred past 0.1.
• Changing an app's mode at runtime, without a redeploy.

What Neolith asks of an app, such as owning its data, is in the FAQ.

1. Read the overview and terms (opens another site), the first document of the specification.
2. Read the vision (opens another site) and the guiding principles (opens another site) to see the trade-offs.
3. Follow the roadmap (opens another site) and watch the repository (opens another site) for the first release.

Planned public surface, abridged from the roadmap. Not installable yet.

from typing import Protocol

from neolith import NeolithAppConfig, contract, action, implements, connect, ContractError

@contract("inventory.v1")
class Inventory(Protocol):
    @action(idempotent=True)
    def reserve(self, request: ReserveRequest) -> ReserveReply: ...

@implements(Inventory)
class InventoryImpl:
    def reserve(self, request: ReserveRequest, ctx: CallContext) -> ReserveReply: ...

class InventoryConfig(NeolithAppConfig):
    name = "inventory"
    provides = ["inventory.v1"]
    requires = []
    resources = {"database": "inventory"}

# in a caller
inventory = connect("inventory.v1")
try:
    reply = inventory.reserve(ReserveRequest(sku="A1", qty=2))
except ContractError as e:
    e.kind  # "unavailable", "conflict", ...

contract, action, implements and ContractError are in the code on main; connect and NeolithAppConfig are not yet. In 0.1, neolith run <app> is planned to boot one app on SQLite, with support planned from Django 5.2 LTS on Python 3.12 up to Django 6.1 on Python 3.15.

Neolith is licensed under BSD-3-Clause, the same license as Django. Read the FAQ.