omnivoice-server 0.1.0__tar.gz

omnivoice_server-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+---
+name: Bug Report
+about: Report a bug to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Describe the bug
+A clear and concise description of what the bug is.
+
+## To Reproduce
+Steps to reproduce the behavior:
+1. 
+2. 
+3. 
+
+## Expected behavior
+A clear and concise description of what you expected to happen.
+
+## Environment
+- OS: [e.g., macOS 13.0, Ubuntu 22.04]
+- Python version: [e.g., 3.10.8]
+- Device: [e.g., CPU, CUDA, MPS]
+- omnivoice-server version: [e.g., 0.1.0]
+
+## Logs
+```
+Paste relevant logs here
+```
+
+## Additional context
+Add any other context about the problem here.

omnivoice_server-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,124 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the form below.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear description of what the bug is
+      placeholder: When I try to..., the server...
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Start server with `omnivoice-server --device cpu`
+        2. Send request to `/v1/audio/speech`
+        3. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen
+      placeholder: The server should return a WAV file
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened (include error messages)
+      placeholder: |
+        Error: ...
+        Traceback: ...
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: omnivoice-server Version
+      description: Output of `omnivoice-server --version` or git commit hash
+      placeholder: "0.1.0"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - Linux
+        - macOS
+        - Windows
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: python
+    attributes:
+      label: Python Version
+      description: Output of `python --version`
+      placeholder: "3.10.12"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: device
+    attributes:
+      label: Device
+      description: What device are you using for inference?
+      options:
+        - CPU
+        - CUDA (NVIDIA GPU)
+        - MPS (Apple Silicon)
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: config
+    attributes:
+      label: Configuration
+      description: Relevant configuration (CLI flags, environment variables)
+      placeholder: |
+        --device cpu
+        --num-step 32
+        OMNIVOICE_API_KEY=...
+    validations:
+      required: false
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Server Logs
+      description: Relevant server logs (if applicable)
+      placeholder: Paste logs here
+      render: shell
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context about the problem
+      placeholder: This started happening after...
+    validations:
+      required: false

omnivoice_server-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Is your feature request related to a problem?
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+## Describe the solution you'd like
+A clear and concise description of what you want to happen.
+
+## Describe alternatives you've considered
+A clear and concise description of any alternative solutions or features you've considered.
+
+## Additional context
+Add any other context or screenshots about the feature request here.

omnivoice_server-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,78 @@
+name: Feature Request
+description: Suggest a new feature or enhancement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature! Please describe what you'd like to see.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve? (optional)
+      placeholder: I'm frustrated when...
+    validations:
+      required: false
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the feature you'd like to see
+      placeholder: I'd like the server to support...
+    validations:
+      required: true
+
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: How would you use this feature?
+      placeholder: |
+        I want to build an app that...
+        This feature would allow me to...
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Have you considered any alternative solutions or workarounds?
+      placeholder: I tried using... but it doesn't work because...
+    validations:
+      required: false
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this feature to you?
+      options:
+        - Nice to have
+        - Would be helpful
+        - Important for my use case
+        - Blocking my project
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: contribution
+    attributes:
+      label: Contribution
+      description: Would you be willing to contribute this feature?
+      options:
+        - label: I'm willing to submit a PR for this feature
+          required: false
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or examples
+      placeholder: Here's a mockup of what I'm thinking...
+    validations:
+      required: false

omnivoice_server-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,27 @@
+## Description
+Brief description of the changes in this PR.
+
+## Type of Change
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+
+## How Has This Been Tested?
+Describe the tests you ran to verify your changes.
+
+- [ ] Test A
+- [ ] Test B
+
+## Checklist
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] Any dependent changes have been merged and published
+
+## Related Issues
+Closes #(issue number)

omnivoice_server-0.1.0/.github/SETUP_METADATA.md

@@ -0,0 +1,67 @@
+# How to Add Repository Metadata on GitHub
+
+After pushing your commits, go to your GitHub repository and add the following metadata:
+
+## 1. Repository Description
+
+Go to: `https://github.com/maemreyo/omnivoice-server`
+
+Click the ⚙️ (Settings) icon next to "About" on the right sidebar, then add:
+
+**Description:**
+```
+OpenAI-compatible TTS server for OmniVoice - Zero-shot voice cloning and multi-language text-to-speech
+```
+
+**Website:**
+```
+https://github.com/maemreyo/omnivoice-server
+```
+
+## 2. Repository Topics
+
+In the same "About" settings dialog, add these topics (click "Add topics"):
+
+```
+text-to-speech
+tts
+voice-cloning
+omnivoice
+openai-compatible
+fastapi
+pytorch
+python
+speech-synthesis
+ai
+machine-learning
+voice-synthesis
+```
+
+## 3. Social Preview Image (Optional)
+
+Go to: `Settings` → `General` → `Social preview`
+
+Upload an image (1280x640px recommended):
+- Use a waveform visualization of the voice samples
+- Or use the OmniVoice logo
+- Or create a simple banner with "OmniVoice Server" text
+
+## 4. Repository Settings
+
+While in Settings, also verify:
+- ✅ Issues enabled
+- ✅ Discussions enabled (optional, for community Q&A)
+- ✅ Wiki disabled (use docs/ instead)
+- ✅ Projects disabled (unless needed)
+
+## Result
+
+After adding metadata, your repository will show:
+- Description in search results
+- Topics as clickable tags
+- Social preview when shared on social media
+- Better discoverability on GitHub
+
+---
+
+**Note**: These settings are stored on GitHub's servers, not in git, so they must be configured through the web interface.

omnivoice_server-0.1.0/.github/repo-metadata.md

@@ -0,0 +1,26 @@
+# Repository Metadata
+
+This file contains metadata for the GitHub repository.
+
+## Description
+OpenAI-compatible TTS server for OmniVoice - Zero-shot voice cloning and multi-language text-to-speech
+
+## Topics
+- text-to-speech
+- tts
+- voice-cloning
+- omnivoice
+- openai-compatible
+- fastapi
+- pytorch
+- python
+- speech-synthesis
+- ai
+- machine-learning
+- voice-synthesis
+
+## Website
+https://github.com/maemreyo/omnivoice-server
+
+## Social Preview
+Use one of the voice sample waveforms or the OmniVoice logo

omnivoice_server-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        run: |
+          pip install ruff
+      - name: Run ruff
+        run: ruff check omnivoice_server/ tests/
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+      - name: Run tests
+        run: pytest tests/ -v

omnivoice_server-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,42 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write  # Required for trusted publishing
+
+jobs:
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build hatchling
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          # Uses OIDC trusted publishing - no API token needed
+          # Configure at: https://pypi.org/manage/account/publishing/
+          # Publisher: GitHub
+          # Owner: maemreyo
+          # Repository: omnivoice-server
+          # Workflow: publish.yml
+          # Environment: (leave blank)
+          verbose: true

omnivoice_server-0.1.0/.gitignore

@@ -0,0 +1,37 @@
+**/__pycache__/**
+.omc
+
+# Environment and secrets
+.env
+.env.local
+*.env
+
+# Python
+*.pyc
+*.pyo
+*.pyd
+__pycache__/
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary files
+*.tmp
+*.log
+
+# Voice samples (stored in GitHub Releases)
+voice_samples/*.wav

omnivoice_server-0.1.0/CHANGELOG.md

@@ -0,0 +1,53 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-04-04
+
+### Added
+
+- Initial release of omnivoice-server
+- OpenAI-compatible TTS API (`/v1/audio/speech`)
+- Three voice modes:
+  - Auto: Model selects voice automatically
+  - Design: Specify voice attributes (gender, age, accent, etc.)
+  - Clone: Voice cloning from reference audio
+- Voice profile management API (`/v1/voices/profiles`)
+  - Create, read, update, delete voice cloning profiles
+  - Persistent storage for reusable voice profiles
+- One-shot voice cloning endpoint (`/v1/audio/speech/clone`)
+- Streaming synthesis support (sentence-level chunking)
+- Model listing endpoint (`/v1/models`)
+- Health check endpoint (`/health`)
+- Metrics endpoint (`/metrics`)
+- CLI interface with `omnivoice-server` command
+- Configuration via environment variables or CLI flags
+- Optional Bearer token authentication
+- Concurrent request handling with configurable limits
+- Request timeout protection
+- Audio format support: WAV and raw PCM
+- Speed control (0.25x - 4.0x)
+- Configurable inference steps (1-64)
+- Python client examples
+- cURL examples
+- Streaming audio player example
+- Comprehensive documentation
+- CI/CD workflow with GitHub Actions
+
+### Technical Details
+
+- Built on FastAPI and Uvicorn
+- Uses OmniVoice model from k2-fsa
+- Supports CUDA, MPS, and CPU inference
+- Thread pool executor for concurrent synthesis
+- Pydantic-based configuration and validation
+- Type hints throughout codebase
+- Async/await for I/O operations
+
+[unreleased]: https://github.com/maemreyo/omnivoice-server/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/maemreyo/omnivoice-server/releases/tag/v0.1.0

omnivoice_server-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing to OmniVoice Server
+
+Thank you for your interest in contributing!
+
+## Quick Start
+
+1. Fork and clone the repository
+2. Install: `pip install -e ".[dev]"`
+3. Create a branch: `git checkout -b feature/your-feature`
+4. Make changes and add tests
+5. Run tests: `pytest tests/ -v`
+6. Run linting: `ruff check omnivoice_server/ tests/`
+7. Commit: `git commit -m "feat: your feature"`
+8. Push and create PR
+
+## Code Style
+
+- Follow PEP 8
+- Use type hints
+- Max line length: 100
+- Run `ruff check --fix` before committing
+
+## Testing
+
+- Write tests for new features
+- Maintain 80%+ coverage
+- Use pytest fixtures
+
+## Commit Convention
+
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation
+- `test`: Tests
+- `refactor`: Refactoring
+
+## Questions?
+
+Open an issue or discussion!

omnivoice_server-0.1.0/Dockerfile

@@ -0,0 +1,46 @@
+# Multi-stage build for omnivoice-server
+FROM python:3.10-slim as builder
+
+WORKDIR /build
+
+# Install build dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy project files
+COPY pyproject.toml README.md ./
+COPY omnivoice_server ./omnivoice_server
+
+# Install PyTorch CPU (smaller image, works everywhere)
+RUN pip install --no-cache-dir torch torchaudio --index-url https://download.pytorch.org/whl/cpu
+
+# Install the package
+RUN pip install --no-cache-dir .
+
+# Runtime stage
+FROM python:3.10-slim
+
+WORKDIR /app
+
+# Install runtime dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    libsndfile1 \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy installed packages from builder
+COPY --from=builder /usr/local/lib/python3.10/site-packages /usr/local/lib/python3.10/site-packages
+COPY --from=builder /usr/local/bin/omnivoice-server /usr/local/bin/omnivoice-server
+
+# Create profile directory
+RUN mkdir -p /app/profiles
+
+# Expose server port
+EXPOSE 8880
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
+    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8880/health')" || exit 1
+
+# Run server
+CMD ["omnivoice-server", "--host", "0.0.0.0", "--port", "8880", "--profile-dir", "/app/profiles"]

omnivoice_server-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zamery (maemreyo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.