als-controls/lightfall

Última atividade de origem registrada: 19 de agosto de 2026 às 02:42

Catálogo do SkillsMP atualizado: 29 de outubro de 2026 às 18:30

skills coletadas: 8

Estrelas no GitHub: 8
Forks no GitHub: 0

Instalar com um assistente de IA

Copie este prompt para o assistente de IA que você usa.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/als-controls/lightfall.

README do repositório

Arquivo de origem do README: README.md

Ler o README original

Expandir README completo

# Lightfall  [![PyPI version](https://img.shields.io/pypi/v/lightfall.svg)](https://pypi.org/project/lightfall/) [![Python versions](https://img.shields.io/pypi/pyversions/lightfall.svg)](https://pypi.org/project/lightfall/) [![CI](https://github.com/als-controls/lightfall/actions/workflows/ci.yml/badge.svg)](https://github.com/als-controls/lightfall/actions/workflows/ci.yml) [![Docs](https://github.com/als-controls/lightfall/actions/workflows/docs.yml/badge.svg)](https://als-controls.github.io/lightfall/) [![License: BSD-3-Clause](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](LICENSE.md)  A modern, unified control system for synchrotron lightsource facilities that provides facility-wide consistency with beamline-specific customization. ## Overview Lightfall is designed for the Advanced Light Source (ALS) facility, providing: - **Unified Interface**: Consistent look-and-feel across beamlines with skinnable themes - **API-First Architecture**: Modular, extensible design enabling automation and integration - **LLM/AI Integration**: Claude-powered chatbot for natural language control and assistance - **FAIR-Compliant Data Management**: Integration with Tiled for data cataloging and access - **Secure Remote Operations**: Full remote operation capability with fine-grained access control ## Features ### User Interface - Progressive disclosure: user panels with expert panels behind authorization - Scripting panel with Jupyter-lab style interface - LLM panel for controlling panels via natural language - GUI Builder for drag-and-drop interface creation - Persistent user preferences saved across sessions ### Device Management - Centralized device catalog with lifecycle tracking - Real-time monitoring via EPICS Channel Access - Version-controlled device configurations - Rich high-level controls integrated into workflows ### Data Acquisition - Bluesky-based acquisition engine - Flexible signal/stream selection with real-time visualization - Interactive, pausable, restartable acquisition - Automatic data persistence to Tiled catalog ### Data Browser - Browse and search data stored in Tiled server - Filter by date range, plan type, exit status - Pagination for large datasets - Click/double-click signals for integration with analysis tools ## Installation ```bash pip install lightfall ``` ### Development Installation ```bash # Clone the repository git clone https://github.com/als-controls/lightfall.git cd lightfall # Create and activate virtual environment python -m venv .venv .venv\Scripts\activate # Windows # or source .venv/bin/activate # Unix # Install in development mode with dev dependencies pip install -e ".[dev]" ``` Lightfall depends on [`lightfall-utils`](https://github.com/als-controls/lightfall-utils) (installed from PyPI like any other dependency). To co-develop both packages, install a sibling checkout in editable mode on top: ```bash git clone https://github.com/als-controls/lightfall-utils.git ../lightfall-utils pip install -e ../lightfall-utils ``` ### Running the Application ```bash lightfall ``` ## Configuration Lightfall uses a layered configuration system: 1. **System defaults** - Built-in defaults 2. **Site configuration** - Facility-wide settings 3. **User preferences** - Personal customizations Configuration files are stored in: - Windows: `%APPDATA%\lightfall\` - Linux/Mac: `~/.config/lightfall/` ## Architecture Lightfall is built on: - **PySide6** - Qt for Python GUI framework - **Bluesky** - Data acquisition framework - **Ophyd** - Device abstraction layer - **Tiled** - Data catalog and access - **EPICS** - Control system communication ### Plugin System Lightfall supports plugins for: - **Panels** - Custom UI panels - **Settings** - Preference pages - **Status Bar** - Status indicators - **Engines** - Acquisition backends - **Plans** - Scan procedures ## Development ### Running Tests ```bash pytest ``` ### Code Quality ```bash # Linting ruff check src tests # Type checking mypy src ``` ## Project Structure ``` lightfall/ ├── src/lightfall/ │ ├── acquire/ # Data acquisition engine (Bluesky RunEngine, plans) │ ├── auth/ # Authentication & authorization │ ├── claude/ # Embedded Claude agent integration │ ├── config/ # Configuration management │ ├── core/ # Core application classes │ ├── devices/ # Device catalog & backends │ ├── epics/ # EPICS (caproto) widgets & helpers │ ├── exporter/ # Data exporter CLI │ ├── ipc/ # Inter-process communication (NATS) │ ├── logbook/ # Logbook client │ ├── pipelines/ # Pipeline client │ ├── plugins/ # Plugin system │ ├── services/ # Application services (Tiled, CA tunnel, etc.) │ ├── settings/ # User-portable settings client │ ├── ui/ # User interface │ │ ├── panels/ # Panel implementations │ │ ├── widgets/ # Reusable widgets │ │ ├── preferences/ # Settings UI │ │ └── theme/ # Theming system │ ├── utils/ # Utilities │ └── visualization/ # Plotting & live visualization └── tests/ # Test suite ```

Carregando o README do repositório…

Skills neste repositório

Desenvolvedores de software Técnicos agrícolas Assistentes de pesquisa em ciências sociais

3 categorias ocupacionais · 100% classificado

skill

ocupação

descrição

atualizado