https://github.com/niamoto/niamoto

Niamoto is a command-line application and library focused on processing and publishing botanical data
https://github.com/niamoto/niamoto

botany cli-application data-analysis data-processing data-publication python-library

Last synced: about 1 month ago
JSON representation

Niamoto is a command-line application and library focused on processing and publishing botanical data

Host: GitHub
URL: https://github.com/niamoto/niamoto
Owner: niamoto
License: gpl-3.0
Created: 2023-11-25T11:20:32.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2026-04-16T20:01:14.000Z (about 1 month ago)
Last Synced: 2026-04-16T22:07:20.988Z (about 1 month ago)
Topics: botany, cli-application, data-analysis, data-processing, data-publication, python-library
Language: Python
Homepage:
Size: 109 MB
Stars: 4
Watchers: 4
Forks: 0
Open Issues: 6
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md

Awesome Lists containing this project

README

Niamoto

Turn ecological data into a biodiversity portal from a native desktop app or a Python CLI.

Download the desktop app
·
Documentation
·
Live demo

Build collections and publish a biodiversity portal from one desktop app.

Niamoto Collections view computing statistics and widgets in the desktop app

Niamoto import screen with auto-detected sources and columns

Niamoto publish screen previewing generated site output

## What Niamoto does

- Import ecological tables, layers, and rasters into one project.
- Suggest file and column roles, so you can start from a working configuration.
- Build collections, widgets, statistics, and maps from that data.
- Publish a static biodiversity portal to GitHub Pages, Cloudflare Workers,
Netlify, Vercel, Render, or your own server over SSH.

The desktop app is the main interface. The Python CLI handles automation, CI,
and repeatable runs.

## Pick your path

| You are… | Start here |
| ---------------- | ------------------------------------------------------------------------------------------------------ |
| A researcher | [Desktop onboarding](https://niamoto.github.io/niamoto/01-getting-started/README.html) |
| A project lead | [User guide](https://niamoto.github.io/niamoto/02-user-guide/README.html) |
| A developer | [Plugin development guide](https://niamoto.github.io/niamoto/04-plugin-development/README.html) |

## Install

### Desktop (recommended)

Signed builds for macOS, Windows, and Linux live on the
[releases page](https://github.com/niamoto/niamoto/releases/latest).

### Command line (automation, CI)

```bash
pip install niamoto
niamoto --help
```

Requires Python 3.12 or newer. See
[CLI & automation docs](https://niamoto.github.io/niamoto/03-cli-automation/README.html)
for scripting recipes.

## Quick start

### Desktop path

1. Download the latest desktop build from the
[releases page](https://github.com/niamoto/niamoto/releases/latest).
2. Grab a sample dataset from
[niamoto-example-data](https://github.com/niamoto/niamoto-example-data) or
open your own CSVs, layers, and rasters.
3. Continue with
[Desktop onboarding](https://niamoto.github.io/niamoto/01-getting-started/README.html)
and then the
[Desktop App Tour](https://niamoto.github.io/niamoto/02-user-guide/README.html).

### CLI path

1. Install the package with `pip install niamoto`.
2. Run `niamoto --help`.
3. Follow the
[CLI & automation docs](https://niamoto.github.io/niamoto/03-cli-automation/README.html)
for project init, scripted runs, and CI.

## Inside the desktop studio

The desktop app takes you from source review to collections, widgets, and
publication in one place. The full walk-through lives in the
[Desktop App Tour](https://niamoto.github.io/niamoto/02-user-guide/README.html).
If you want to see the generated result first,
[the live demo](https://niamoto.github.io/niamoto-static-site/) shows what the
published portal looks like.

## Resources

- **Documentation** — [niamoto.github.io/niamoto](https://niamoto.github.io/niamoto/)
- **Live demo** — [New Caledonia forests portal](https://niamoto.github.io/niamoto-static-site/)
- **Discussions** — [GitHub Discussions](https://github.com/niamoto/niamoto/discussions)
- **Issues** — [GitHub Issues](https://github.com/niamoto/niamoto/issues)
- **Roadmap** — [ROADMAP.md](https://github.com/niamoto/niamoto/blob/main/ROADMAP.md) · vision, current priorities, and the GBIF Challenge 2026 milestone
- **Changelog** — [CHANGELOG.md](https://github.com/niamoto/niamoto/blob/main/CHANGELOG.md)
- **Contributing** — [CONTRIBUTING.md](https://github.com/niamoto/niamoto/blob/main/CONTRIBUTING.md) · [STYLE_GUIDE.md](https://github.com/niamoto/niamoto/blob/main/docs/STYLE_GUIDE.md)

## About Niamoto

Niamoto is developed by a small interdisciplinary team and supported by institutional partners committed to biodiversity conservation.

### Niamoteam

Open-source collaborative project for biodiversity conservation.

- **Philippe Birnbaum** — CIRAD · UMR AMAP
- **Dimitri Justeau-Allaire** — IRD · UMR AMAP
- **Gilles Dauby** — IRD · UMR AMAP
- **Julien Barbe** — Developer

### Partners & funders

Niamoto was developed within the ADMIRE research project ("Partnership for the Analysis of Reforestation Dynamics and Forest Resilience"), established by Province Nord, IAC, and Cirad. The project develops software that supports decision-making for the management of natural areas in Province Nord, New Caledonia.