Introduction

The 30CES project is a colloborative effort at CSU - Bakersfield in the Department of Biology, under the guidance of Dr. Luke Hall, PhD, and lead by Gradute students Megan McCullah-Boozer and Rachel Budge.

Stack

• Streamlit
• birdnetlib

Installation and Usage Guide

Astral UV (or simply "UV") is a fast, modern Python package management tool designed as a drop-in replacement for pip, pip-tools, and virtualenv. This guide explains how to install and use UV on both macOS and Windows systems.

Table of Contents

• Installation
  • macOS Installation
  • Windows Installation
• Basic Usage
  • Creating Virtual Environments
  • Activating Virtual Environments
  • Installing Packages
  • Installing from requirements.txt
• Troubleshooting

Installation

macOS Installation

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows Installation

Using PowerShell (Official Installation Script)

irm https://astral.sh/uv/install.ps1 | iex

Basic Usage

Creating Virtual Environments

Create a new virtual environment in the current directory:

uv venv

This creates a .venv directory with a Python environment.

To use a specific Python version:

uv venv --python=python3.11

Or use the included python virtual environment.

Activating Virtual Environments

On macOS/Linux:

source .venv/bin/activate

On Windows:

.venv\Scripts\activate

Installing Packages

Installing from requirements.txt

uv pip install -r requirements.txt

Troubleshooting

Common Issues

"Command not found" after installation:

• Make sure the installation directory is in your PATH
• Restart your terminal or command prompt

Permission errors on macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sudo sh

Windows execution policy issues:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
irm https://astral.sh/uv/install.ps1 | iex

Launch WebUI:

streamlit run ui/Home.py

The WebUI uses Streamlit to simplify develpment and usage.

Compatibility with existing environments: UV is designed to be compatible with environments created by virtualenv/venv.

For more information, visit the official Astral UV documentation.

30CES

Make sure to double check variables:

• min_conf = 0.7
• padding_secs = 0.5
• dpi = 300
• audio_format = 'wav'
• spectrogram_format = 'jpg'

30CES is not associated with BirdNET-Lite, BirdNET-Analyzer, birdnetlib or the K. Lisa Yang Center for Conservation Bioacoustics.

CONTRIBUTIONS

Always welcome:)