Metadata-Version: 2.4
Name: semcod
Version: 0.1.11
Summary: A Python package for musical string manipulation and analysis
Author-email: Tom Sapletta <tom@sapletta.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/semcod/regen
Project-URL: Documentation, https://github.com/semcod/regen#readme
Project-URL: Repository, https://github.com/semcod/regen.git
Project-URL: Bug Tracker, https://github.com/semcod/regen/issues
Keywords: music,audio,harp,sound,synthesis
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.19.0
Requires-Dist: soundfile>=0.10.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: black>=21.0; extra == "dev"
Requires-Dist: flake8>=3.8; extra == "dev"
Requires-Dist: mypy>=0.800; extra == "dev"
Requires-Dist: goal>=2.1.0; extra == "dev"
Requires-Dist: costs>=0.1.20; extra == "dev"
Requires-Dist: pfix>=0.1.60; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=4.0; extra == "docs"
Requires-Dist: sphinx-rtd-theme>=0.5; extra == "docs"
Dynamic: license-file

# Harp


## AI Cost Tracking

![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.10-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
![AI Cost](https://img.shields.io/badge/AI%20Cost-$1.20-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-2.4h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)

- 🤖 **LLM usage:** $1.2000 (8 commits)
- 👤 **Human dev:** ~$238 (2.4h @ $100/h, 30min dedup)

Generated on 2026-05-10 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)

---

A Python package for musical string manipulation and analysis, particularly focused on harp-like string instruments and their properties.

## Features

- Musical note and frequency conversion utilities
- String vibration modeling
- Harp instrument simulation
- Audio analysis tools for string instruments

## Installation

```bash
pip install harp
```

## Quick Start

```python
from harp import Harp, note_to_frequency, frequency_to_note

# Convert between notes and frequencies
freq = note_to_frequency('A4')
note = frequency_to_note(440.0)

# Create a harp with standard tuning
harp = Harp(num_strings=47)
harp.tune_to_standard()

# Play a note
harp.pluck_string(0, velocity=0.8)
```

## Development

Install in development mode:

```bash
git clone https://github.com/yourusername/harp.git
cd harp
pip install -e .[dev]
```

This package uses modern Python packaging with `pyproject.toml`. No `setup.py` file is required.

Run tests:

```bash
pytest
```

## License

Licensed under Apache-2.0.
