Vibe Toxicology LIS

Presentation website · Documentation · Contributing · Security

A free, open-source laboratory information system (LIS) for small US clinical toxicology laboratories. It runs as a desktop application on one laboratory computer, which holds the laboratory's records, and covers a test from order to delivered report: orders, specimens and labels, analyzer and result-file intake, quality control, review and release, delivery, clinical billing handoff, audit, backup and data export. It is built with a Rust engine, Tauri 2 and a TypeScript/React interface for Windows, macOS and Linux. See the product at a glance and the project scope for what it covers and excludes.

Status: development on synthetic data. There is no supported installer release or clinically validated application. The implementation status records current capability; quality guidance and limitations record what remains before laboratory use.

Run from source

Unsigned development installers for Windows, macOS and Linux are on the releases page: a nightly prerelease of develop and versioned releases from main (branches and releases). To run from source, install Rust through rustup (the repository pins its toolchain), Node.js 24 with npm, and the Tauri 2 prerequisites for your operating system. Then, from a clone of the repository:

npm ci
npm run tauri dev

The developer guide covers platform-specific build tools, narrower commands and the quality gate. Use synthetic data only.

License and development disclaimer

Copyright 2026 Vibe Toxicology LIS contributors. Respective rights holders retain ownership; this attribution does not assign rights to a separate organization. The project's own code, documentation, synthetic fixtures, website and original presentation assets are licensed under the GNU General Public License, version 3 only (GPL-3.0-only), unless otherwise identified. Third-party material retains its own terms. Use, modification and redistribution, including commercial sale, are permitted. Distributors must preserve the GPL rights and provide the corresponding source as the license requires. Private internal modifications do not require public release; GPLv3 adds no AGPL-style network-source requirement. The license decision defines the project license and distribution responsibilities.

This project is vibe coded: developed with substantial AI assistance and reasonable effort in research, planning, analysis, review and testing. That effort does not guarantee correctness, security, regulatory compliance or fitness for clinical use. The work is provided as is, with the warranty disclaimers and liability limitations in GPLv3 sections 15–17, subject to applicable law and written agreements. See the full development disclaimer, which does not modify the license or add use restrictions.

Start here

1. At a glance and project scope: the product, its confirmed clinical scope and exclusions.
2. Documentation index: operation, development, architecture, requirements and supporting evidence.
3. Architecture overview and decision records: accepted decisions and remaining proposals.
4. Open questions: decisions requiring laboratory, counsel or project-owner input.
5. AGENTS.md: instructions for any agent working here; .ai/ contains reusable role definitions and skills.

For hands-on use, see the laboratory operator guide and developer guide.

See contribution guidance, security reporting status, and the open-source strategy.