Open SourceApache License 2.0

AlpsDataFarm is
open at its core.

The platform infrastructure — data models, REST API, geo integrations, lab workflows — is fully open source under the Apache License 2.0. Build on it, fork it, self-host it.

View on GitHub
LicenseApache 2.0LanguagePython + TypeScriptBackendDjango RESTFrontendNext.js 14

Open Source Core

These modules are free forever — fork, modify, self-host.

🔐core/

User management, authentication, project access control

Apache 2.0
🗺️geo/

Sites, farming systems, map layers, INVEKOS & Bodenkarte proxy

Apache 2.0
🌱sampling/

Field soil samples, depth horizons, sample types and images

Apache 2.0
🔬lab/

Lab devices, analysis types, measurement results

Apache 2.0
📊analytics_core/

KPI summary, super-merge export, query service

Apache 2.0

Core API Reference

This section documents only the open-source core endpoints. Premium or hosted-only routes are intentionally excluded.

Authorization

Cookie-based JWT auth (access cookie)

Response Header

No custom API response headers are currently implemented. Clients should rely on standard HTTP status codes and JSON response bodies.

Rate Limits

Free: Default: Disabled

Pro: Self-hosted administrators can configure custom limits via environment variables.

POST/api/auth/login
POST/api/auth/register
POST/api/auth/refresh

Tech Stack

⚙️BackendDjango + Django REST Framework
🔒AuthSimpleJWT
FrontendNext.js 14 + TypeScript
🎨StylingTailwind CSS
🗺️MapsMapLibre GL JS
🗄️DatabasePostgreSQL + PostGIS
📉Analytics DBDuckDB
🌐ExternalINVEKOS + Bodenkarte

Contributing

Bug fixes, new integrations, translations — all welcome.

01

Fork the repository

gh repo fork farmse988/alpsdatafarm-community
02

Copy environment file

cp backend/.env.example backend/.env
# Edit .env with your values
03

Start with Docker

make build
make migrate
04

Create a feature branch

git checkout -b feature/your-feature-name
05

Open a Pull Request

gh pr create --title 'feat: your feature' --body '...'

🚀 Launch Platform

Launch the full platform with a single command – local or via Docker.

CLI
make build
First time setupmake build
Initialize databasemake migrate
Start platformmake up
View logsmake logs
Stop platformmake down
Docker (future)
docker run alpsdatafarm/init

Runs the full stack (Next.js + Django + PostgreSQL/PostGIS) via Docker in one command. Requires Docker & Docker Compose.

Roadmap

Interactive development roadmap of the Open Core system.

v0.1 — Now

Project and site management
Soil sampling workflow
Lab analysis data capture
Geo mapping with INVEKOS/Bodenkarte
REST API + cookie-based JWT auth
Basic analytics and export
Progress100%

Build with us

AlpsDataFarm is built for soil scientists, agronomists, farmers and environmental reporting workflows. From field to policy — we turn field data into decisions.