Skip to content

mohaneddz/Biblos

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

38 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Biblos β€” Interactive Biodiversity Explorer

Biblos is a Tauri desktop application for exploring species, ecosystems, taxonomy, and natural-history media. It combines curated local data with optional live species services and interactive visual tools.


Tech Used

Tauri React TypeScript Vite Rust


Features

  • Explore curated species, ecosystems, and the tree of life
  • Species search, detailed profiles, classification tree, and comparison view
  • Personal collections and folders
  • Optional live data and media services, including GBIF, iNaturalist, Wikipedia, and YouTube
  • AI Naturalist workspace and natural-language species tooling
  • Rust index-seeding command for local data setup, bundled with a pre-seeded species database

Screenshots

Biblos species explorer home screen

Home: Search the species directory, access quick portal actions, and view daily animal highlights and recently explored records.

Biblos species directory view

Species: Search and filter thousands of indexed species records using real-time taxonomy, habitat, diet, and conservation status filters.

Biblos tree of life view

Tree of Life: Navigate global biological classification and animal classes through an interactive hierarchical taxonomy tree.

Biblos explorer view

Explorer: Discover Earth's wildlife across biomes, dietary patterns, activity rhythms, conservation tiers, and geographic regions.

Biblos ecosystems view

Ecosystems: Browse global biomes and detailed habitat records alongside their representative species.

Biblos AI naturalist chatbot view

AI Naturalist: Consult an intelligent conversational AI assistant for natural-history insights and detailed species analysis.

Biblos species comparison view

Compare: Perform side-by-side comparative analysis of species physical traits, habitats, diets, and taxonomy.

Biblos collection and folders view

Collection: Organize starred favorites, bookmarked species records, and custom research folders.

Biblos settings view

Settings: Manage application caching, local storage, API keys, error logs, and user preferences.


Project Structure

src/
|-- assets/                 # Brand graphics
|-- components/             # Search, species, taxonomy, collection, and modal UI
|-- data/                   # Curated animals, discovery, ecosystems, tree-of-life data
|-- pages/                  # Explorer, species, ecosystems, compare, collection, settings
|-- services/               # Live data, media, cache, AI, and search services
|-- hooks/                  # Species-media hooks
|-- App.tsx                 # Main application and routes
`-- main.tsx                # React entry point

src-tauri/
|-- src/                    # Tauri backend and seed binary
|-- tauri.conf.json         # Desktop window and bundle configuration
`-- Cargo.toml              # Rust dependencies

Getting Started

Prerequisites

  • Node.js 18+
  • pnpm
  • Rust toolchain
  • Tauri system dependencies for your operating system

Install and run

pnpm install
pnpm tauri dev

For frontend-only development:

pnpm dev

The Vite server is configured for http://localhost:8668.


Available Scripts

pnpm dev           # Start Vite
pnpm build         # Type-check and build frontend assets
pnpm preview       # Preview the production frontend build
pnpm tauri dev     # Run the desktop app
pnpm tauri build   # Build the production desktop bundle
pnpm seed:index    # Run the Biblos Rust index seeder

Exploration Modes

  • Species: Search the directory and open detailed species records.
  • Explorer: Browse discovery data and filter the natural world by topic.
  • Tree of Life: Follow classification relationships from broad groups to individual species.
  • Ecosystems: Explore ecosystem records and their species context.
  • Compare: Place species side by side for a focused comparison.
  • Collection: Save records into personal folders.

Data and Media Notes

  • Curated data is bundled under src/data so the core experience is immediately explorable.
  • Service modules provide optional live species, taxonomy, media, and video enrichment.
  • The app includes caching, error reporting, confirmation, and toast services to support long-running exploration workflows.
  • Some advanced features, such as 3D viewing and AI Naturalist tools, rely on their respective frontend service modules and available external providers.

About

ππˆππ‹πŽπ’ is an AI-assisted biodiversity explorer built with Tauri, React, TypeScript, Three.js, and interactive natural-history data.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages