Skip to main content

Resp-Agent

A multi-agent framework for respiratory sound diagnosis and generation using deep learning.

Installation

1. Install PyTorch with CUDA Support

pip install torch==2.8.0 torchaudio==2.8.0 --index-url https://download.pytorch.org/whl/cu128

2. Install resp-agent

pip install resp-agent -i https://pypi.org/simple/

This installs all dependencies for both inference and training (including deepspeed, wandb, matplotlib, etc.).

Quick Start

Python API

from resp_agent import BEATs, BEATsConfig
from resp_agent.diagnoser import run_diagnoser
from resp_agent.generator import run_generator

# Diagnose respiratory sounds
result = run_diagnoser(
    audio_dir="./audio",
    output_dir="./output",
    metadata_csv="./metadata.csv",
    config_path="./Diagnoser/config.yaml"
)

# Generate respiratory sounds
audio = run_generator(
    ref_audio="./reference.wav",
    disease="Asthma",
    out_dir="./generated",
    config_path="./Generator/config.yaml"
)

Command Line Interface

# Run diagnosis
resp-agent diagnose --audio_dir ./audio --output_dir ./output --metadata_csv ./metadata.csv --config ./Diagnoser/config.yaml

# Run generation
resp-agent generate --ref_audio ./ref.wav --disease Asthma --out_dir ./output --config ./Generator/config.yaml

# Start interactive chat agent
resp-agent chat --lang zh  # Chinese
resp-agent chat --lang en  # English

Requirements

  • Python >= 3.8
  • PyTorch >= 2.0.0 (recommended: 2.8.0 with CUDA 12.8)
  • CUDA-capable GPU (recommended for training and inference)

Environment Variables

Set your DeepSeek API key for the Thinker agent:

export DEEPSEEK_API_KEY='your-api-key'

License

MIT License

Metadata

Release files for resp-agent 0.1.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for resp-agent 0.1.8
File Size Uploaded Provenance Actions
resp_agent-0.1.8.tar.gz 47.5 kB Without provenance Details for resp_agent-0.1.8.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for resp-agent 0.1.8
File Interpreter ABI Platform Actions
resp_agent-0.1.8-py3-none-any.whl Python 3 none any Details for resp_agent-0.1.8-py3-none-any.whl

Total release size: 101.1 kB

Release files / resp_agent-0.1.8.tar.gz

Download URL resp_agent-0.1.8.tar.gz
Size 47.5 kB
Tags Source
SHA-256 checksum
How to use checksums
13dfe8902e0442b918ef330dfe962a0a26a87175737fb17f98720f672fa469a3
BLAKE2b-256 checksum
How to use checksums
a5e8795d6f70f1e71b16bfe35ac87b600914ddb7bb67ed5627697bebad918f55
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.7

Release files / resp_agent-0.1.8-py3-none-any.whl

Download URL resp_agent-0.1.8-py3-none-any.whl
Size 53.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e1a7609162d08ec13b808df9adcab3ce9b1c6ce92aaeb276c8bc1b25218e782c
BLAKE2b-256 checksum
How to use checksums
b4244364bf68f40a3294d4d2a962e65615eed1034d00fd0c21492ad4dddfadb9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.7

Security for resp-agent 0.1.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page