Website   -   Docs   -   Issues

[!WARNING] LongLink is currently in development.
APIs, features, license and documentation may change as the project evolves.

Introduction

AI has changed the economics and cost structure of software creation. As business software becomes faster and cheaper to build, more workflows, processes, and operational needs can be expressed directly in code. However, without the right engineering foundations, complexity, fragility, and technical debt can gradually erode those initial benefits over time.

LongLink provides that foundation. It turns real-world processes into maintainable business software built with Python. Each project becomes a Solution, while the Platform handles common needs: authentication, permissions, deployment, storage, routing, logging, governance, and operational structure. Users define how the work should happen; developers focus on the business logic.

Specific workflows can be customized through code, built quickly with modern AI-assisted tooling, and maintained with the discipline of proper engineering. LongLink brings software-development principles to the broader world of work, making valuable processes structured, deployable, reviewable, and economical to maintain over time.

Getting Started

Requirements: Python 3.12 or newer.

uvx longlink init --folder <folder>
cd <folder>
uv sync
uv run longlink migrate
uv run longlink dev

python -m pip install longlink
longlink init --folder <folder>
cd <folder>
python -m venv .venv
source .venv/bin/activate
python -m pip install -e .
longlink migrate
longlink dev

Goals

• Keep it simple: Processes are clear, easy to operate and cheap to maintain.
• Own the process: Retain control, accountability and software that fits the work.
• Separate responsibilities: Clear distinction between a machine and a human task.

LongLink aims to bring software-development principles to the way organisations design and operate their processes by creating a clear boundary between what is a computer task and what requires a human decision. This approach aligns with UN Sustainable Development Goal 9 and supports organisations working towards relevant ISO certifications and guidance, including ISO 9001, ISO 22301, ISO 31000, ISO 37301, and ISO 37000.

Development

Work on the LongLink Platform:

make install
make up     # Create local infrastructure
make api    # In one terminal
make image  # Build and push the sample Solution after the API starts
make seed   # In another terminal after the image is available
make web    # In another terminal

Work on the LongLink SDK runtime:

make sdk

To test a local Solution update, edit the generated project under sdk/dev, then run:

make image  # Build and push localhost:15000/sample:dev, preserving your edits

Cleanup

make down  # Stop local services and the cluster