Solutions

The LongLink SDK helps you build a Solution as a standard FastAPI project. The source stays yours, including its data models, rules, workflows, integrations, and API routes. LongLink does not replace the tools you already use. At runtime, the Solution runs as a FastAPI service that you can structure in the way that fits your team.

The SDK connects that service to LongLink when needed. It provides database and storage access, identifies the signed-in user, packages the source for deployment, and exposes XML interfaces to the LongLink control plane. These interfaces are called Solution Views. The Platform displays each view consistently while the service owns the information and actions behind it.

Create a Project

bash
uv add longlink
uv run longlink init

The command creates a project scaffold with everything needed to get started.

├── src/                  # Project source code
│   ├── models/           # SQLModel database tables
│   ├── views/            # Solution View definitions
│   ├── routes/           # FastAPI route modules
│   ├── schemas/          # Pydantic request and response schemas
│   ├── services/         # Service modules
│   └── envs.py           # Environment settings
├── migrations/           # Alembic migrations
├── tests/                # Project tests
├── main.py               # Service entry point
├── pyproject.toml        # Project configuration
├── .env.sample           # Environment template
├── .gitignore
├── AGENTS.md             # Project agent guide
└── README.md

For a small working project, see the LongLink sample repository(opens in new tab).

Local Development

bash
uv sync --group dev
uv run longlink dev

Navigate to http://127.0.0.1:1707(opens in new tab) to preview the service locally.