# MarACO - Marine Acoustic Classification API
A Python package for marine acoustic sound classification optimized for CPU usage with balanced speed and accuracy.
## Features
- **Fast Classification**: <200ms per 5-second audio clip on CPU
- **High Accuracy**: >90% accuracy on marine acoustic sounds
- **Noise Reduction**: Built-in noise reduction and audio preprocessing
- **Multiple Classes**: Fin Whale, Humpback Whale, Right Whale, Sonar, Vessels, Explosions, Physical Noise
- **Easy Integration**: Simple API for quick integration into your projects
- **CPU Optimized**: Designed specifically for CPU-only environments
## Installation
```bash
pip install maraco-api
```
## Quick Start
```python
from maraco import MarineAcousticClassifier
# Initialize classifier
classifier = MarineAcousticClassifier()
# Classify a single audio file
result = classifier.predict("audio_file.wav")
print(f"Class: {result['class']}, Confidence: {result['confidence']:.2f}")
# Batch processing
results = classifier.predict_batch(["file1.wav", "file2.wav"])
for result in results:
print(f"File: {result['filename']}, Class: {result['class']}")
```
## Supported Audio Formats
- WAV, AIFF, MP3, FLAC
- Sample rates: 600Hz - 48kHz (automatically resampled)
- Duration: 1-30 seconds (optimal: 2-5 seconds)
## Performance
- **Processing Speed**: <200ms per clip
- **Memory Usage**: <500MB RAM
- **Model Size**: <50MB
- **Accuracy**: >90% on test data
## License
MIT License
Raw data
{
"_id": null,
"home_page": "https://github.com/maraco/maraco-api",
"name": "maraco-api",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "MarACO Team <contact@maraco.ai>",
"keywords": "marine, acoustic, classification, machine learning, audio, whale, sonar, ocean, bioacoustics, marine biology, sound detection, audio analysis, marine monitoring",
"author": "MarACO Team",
"author_email": "MarACO Team <contact@maraco.ai>",
"download_url": "https://files.pythonhosted.org/packages/c5/fd/b2ea0fe7fa70c47833061cba89934cc0c19407932f46ac61b735114c3b4f/maraco_api-0.1.0.tar.gz",
"platform": null,
"description": "# MarACO - Marine Acoustic Classification API\r\n\r\nA Python package for marine acoustic sound classification optimized for CPU usage with balanced speed and accuracy.\r\n\r\n## Features\r\n\r\n- **Fast Classification**: <200ms per 5-second audio clip on CPU\r\n- **High Accuracy**: >90% accuracy on marine acoustic sounds\r\n- **Noise Reduction**: Built-in noise reduction and audio preprocessing\r\n- **Multiple Classes**: Fin Whale, Humpback Whale, Right Whale, Sonar, Vessels, Explosions, Physical Noise\r\n- **Easy Integration**: Simple API for quick integration into your projects\r\n- **CPU Optimized**: Designed specifically for CPU-only environments\r\n\r\n## Installation\r\n\r\n```bash\r\npip install maraco-api\r\n```\r\n\r\n## Quick Start\r\n\r\n```python\r\nfrom maraco import MarineAcousticClassifier\r\n\r\n# Initialize classifier\r\nclassifier = MarineAcousticClassifier()\r\n\r\n# Classify a single audio file\r\nresult = classifier.predict(\"audio_file.wav\")\r\nprint(f\"Class: {result['class']}, Confidence: {result['confidence']:.2f}\")\r\n\r\n# Batch processing\r\nresults = classifier.predict_batch([\"file1.wav\", \"file2.wav\"])\r\nfor result in results:\r\n print(f\"File: {result['filename']}, Class: {result['class']}\")\r\n```\r\n\r\n## Supported Audio Formats\r\n\r\n- WAV, AIFF, MP3, FLAC\r\n- Sample rates: 600Hz - 48kHz (automatically resampled)\r\n- Duration: 1-30 seconds (optimal: 2-5 seconds)\r\n\r\n## Performance\r\n\r\n- **Processing Speed**: <200ms per clip\r\n- **Memory Usage**: <500MB RAM\r\n- **Model Size**: <50MB\r\n- **Accuracy**: >90% on test data\r\n\r\n## License\r\n\r\nMIT License\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Marine Acoustic Classification API - CPU-optimized marine sound classification",
"version": "0.1.0",
"project_urls": {
"Bug Reports": "https://github.com/maraco-ai/maraco-api/issues",
"Documentation": "https://maraco-api.readthedocs.io/",
"Homepage": "https://maraco.ai",
"Repository": "https://github.com/maraco-ai/maraco-api",
"Source": "https://github.com/maraco-ai/maraco-api"
},
"split_keywords": [
"marine",
" acoustic",
" classification",
" machine learning",
" audio",
" whale",
" sonar",
" ocean",
" bioacoustics",
" marine biology",
" sound detection",
" audio analysis",
" marine monitoring"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8bff39f3b0dec8e8e532955ec34d5b9486aa89c15e7787953e4cca5d98f64696",
"md5": "8b0b7760d66aeda1cce67e63a9ba7a57",
"sha256": "6130a9d885db05da64f940d2e37a11b2cbbeaea22d252c0b6d571b7cc64e35e0"
},
"downloads": -1,
"filename": "maraco_api-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8b0b7760d66aeda1cce67e63a9ba7a57",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 27982,
"upload_time": "2025-10-18T20:08:48",
"upload_time_iso_8601": "2025-10-18T20:08:48.674267Z",
"url": "https://files.pythonhosted.org/packages/8b/ff/39f3b0dec8e8e532955ec34d5b9486aa89c15e7787953e4cca5d98f64696/maraco_api-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c5fdb2ea0fe7fa70c47833061cba89934cc0c19407932f46ac61b735114c3b4f",
"md5": "7e3e41f54766573e517533c27d261203",
"sha256": "adeea9ebe0326c20ea7d07e654f05312ad09492c1378ce1ffb27f5bf8a6fec20"
},
"downloads": -1,
"filename": "maraco_api-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "7e3e41f54766573e517533c27d261203",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 32714,
"upload_time": "2025-10-18T20:08:49",
"upload_time_iso_8601": "2025-10-18T20:08:49.830199Z",
"url": "https://files.pythonhosted.org/packages/c5/fd/b2ea0fe7fa70c47833061cba89934cc0c19407932f46ac61b735114c3b4f/maraco_api-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-18 20:08:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "maraco",
"github_project": "maraco-api",
"github_not_found": true,
"lcname": "maraco-api"
}
JSON
