Metadata-Version: 2.4
Name: pepcalc-ai
Version: 0.1.0
Summary: Tiny unit-conversion helpers for reconstitution math: mg/mL concentration, volume to draw and U-100 syringe units. Educational information only.
Author: PepCalc AI
License-Expression: MIT
Project-URL: Homepage, https://pepcalc.ai
Project-URL: Source, https://github.com/PepCalAI/pepcalc-ai
Keywords: calculator,concentration,mg-per-ml,syringe-units,u-100,peptide-calculator,reconstitution
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Education
Classifier: Topic :: Education
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# pepcalc-ai — free peptide reconstitution & syringe-unit calculator ([pepcalc.ai](https://pepcalc.ai))

> **Educational information only. Not medical advice.**

A tiny, dependency-free Python library and CLI for the general arithmetic behind reconstitution calculators: concentration in mg/mL, the volume containing a target amount, and U-100 syringe units. It contains no recommendations about amounts to use for any person or purpose.

## Install

```bash
pip install pepcalc-ai
```

## Usage

```python
from pepcalc_ai import concentration_mg_per_ml, volume_for_amount_ml, syringe_units

conc = concentration_mg_per_ml(vial_mg=10, diluent_ml=2)   # 5.0 mg/mL
vol = volume_for_amount_ml(amount_mg=1, concentration_mg_per_ml=conc)  # 0.2 mL
units = syringe_units(vol)                                  # 20.0 units on a U-100 syringe
```

CLI:

```bash
pepcalc-ai --vial-mg 10 --diluent-ml 2 --amount-mg 1
```

## Formulas

- concentration (mg/mL) = vial mg ÷ diluent mL
- volume (mL) = target mg ÷ concentration (mg/mL)
- U-100 syringe units = volume (mL) × 100

## Development

```bash
pip install -e . pytest
pytest
```

## Disclaimer

Educational information only. Not medical advice. This software is provided as-is under the MIT license.

## License

MIT
