Metadata-Version: 2.4
Name: temporalvoicesdk
Version: 0.1.0
Summary: Temporal Voice SDK - Advanced voice analytics and recognition
Home-page: https://github.com/TemporalAITech/TemporalVoiceSDK
Author: Temporal AI Technologies Inc.
Author-email: "Temporal AI Technologies Inc." <support@temporalaitechnologies.com>
License: # Temporal AI Technologies Inc. Proprietary License
        
        **Copyright © 2023–2025 Temporal AI Technologies Inc.**  
        All rights reserved.
        
        This software and associated documentation files (the “Software”) contain proprietary and confidential information of Temporal AI Technologies Inc. and are protected by applicable copyright, trade secret, and intellectual property laws.
        
        ---
        
        ## 1. LICENSE GRANT
        
        Subject to payment of applicable license fees and compliance with these terms,  
        **Temporal AI Technologies Inc.** grants you a limited, non-transferable, non-exclusive, non-sublicensable license to use the Software solely for your internal business purposes.
        
        ---
        
        ## 2. USAGE TIERS
        
        | Tier            | Description                                                              |
        |-----------------|--------------------------------------------------------------------------|
        | Free Tier       | Limit of **10 voice samples/day**. Basic analysis features only.         |
        | Standard Tier   | **$99/month** – Up to **100 voice samples/day**. Full analytics access.  |
        | Pro Tier        | **$499/month** – Unlimited usage. Priority processing.                   |
        | Enterprise Tier | Custom pricing – SLAs, dedicated support, custom integrations.           |
        
        ---
        
        ## 3. RESTRICTIONS
        
        You shall not:
        - Modify, reverse engineer, decompile, or disassemble the Software
        - Share access credentials or circumvent licensing mechanisms
        - Use the Software to develop competing products
        - Remove or alter any proprietary notices
        - Exceed usage limits specified in your license tier
        
        ---
        
        ## 4. INTELLECTUAL PROPERTY
        
        All rights, title, and interest in the Software, including all intellectual property rights, remain with **Temporal AI Technologies Inc.**  
        No ownership rights are transferred under this license.
        
        ---
        
        ## 5. DATA COLLECTION
        
        Temporal AI Technologies Inc. may collect anonymized usage data to:
        - Improve the Software
        - Verify compliance with license terms
        
        ---
        
        ## 6. TERMINATION
        
        This license will automatically terminate upon any breach of the terms herein.  
        Upon termination, you must immediately cease all use of the Software and destroy all copies.
        
        ---
        
        ## 7. WARRANTY DISCLAIMER
        
        THE SOFTWARE IS PROVIDED **“AS IS”**, WITHOUT WARRANTY OF ANY KIND.  
        TEMPORAL AI TECHNOLOGIES INC. DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO:
        - IMPLIED WARRANTIES OF MERCHANTABILITY
        - FITNESS FOR A PARTICULAR PURPOSE
        - NON-INFRINGEMENT
        
        ---
        
        ## 8. LIMITATION OF LIABILITY
        
        IN NO EVENT SHALL TEMPORAL AI TECHNOLOGIES INC. BE LIABLE FOR:
        - INDIRECT, INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES
        - LOSS OF PROFITS, REVENUE, OR BUSINESS INTERRUPTION
        
        ---
        
        ## 9. GOVERNING LAW
        
        This license agreement shall be governed by the laws of the jurisdiction in which Temporal AI Technologies Inc. is registered (e.g., **Wyoming, USA**), without regard to conflict of law principles.
        
        ---
        
        **“Temporal AI Technologies”** and related logos are trademarks of Temporal AI Technologies Inc.  
        For licensing inquiries, contact: [legal@temporalai.com](mailto:legal@temporalai.com)
        
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: plotly
Requires-Dist: speechrecognition
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# TemporalVoiceSDK

### Advanced Voice Pattern Recognition & Visualization  
© 2023–2025 Temporal AI Technologies Inc. All Rights Reserved.  
*Proprietary and Confidential. Subject to license terms.*

---

## 🧠 Overview

**TemporalVoiceSDK** is a comprehensive Python package for advanced voice analytics.  
It enables developers to extract, analyze, and visualize voice patterns — including clarity, emotion, and speech confidence — for real-time or offline applications.

---

## ✨ Features

- 🎙️ Process audio files to extract voice features and metrics  
- 🧠 Analyze speech clarity, emotion, confidence, and voice patterns  
- 📊 Generate interactive Plotly visualizations (radar charts, dashboards)  
- 📈 Track training progress and usage metrics  
- 🔌 Integrate easily with Streamlit, Flask, or other Python apps

---

## 🚀 Installation

### From GitHub (latest version)

```bash
pip install git+https://github.com/TemporalAITech/TemporalVoiceSDK.git
```

---

## ⚡ Quick Start

### Basic Voice Analysis

```python
from voice_analytics import VoiceAnalyzer
import io

# Initialize the analyzer
analyzer = VoiceAnalyzer()

# Analyze an audio file
with open('sample.wav', 'rb') as audio_file:
    metrics = analyzer.analyze_audio(audio_file)
    
print(metrics)
```

---

### Visualize Voice Patterns

```python
from voice_analytics import VoiceAnalyzer, VoiceVisualizer
import plotly.io as pio

# Initialize the analyzer and visualizer
analyzer = VoiceAnalyzer()
visualizer = VoiceVisualizer()

# Analyze voice patterns from audio
with open('sample.wav', 'rb') as audio_file:
    audio_data = audio_file.read()
    patterns = analyzer.analyze_voice_patterns(audio_data)

# Create radar chart
fig = visualizer.create_pattern_radar(patterns, title="Voice Pattern Analysis")
pio.write_html(fig, 'voice_patterns.html')
```

---

### Create a Metrics Dashboard

```python
from voice_analytics import VoiceAnalyzer, VoiceVisualizer
import plotly.io as pio

analyzer = VoiceAnalyzer()
visualizer = VoiceVisualizer(dark_mode=True)

for audio_file in ['sample1.wav', 'sample2.wav', 'sample3.wav']:
    with open(audio_file, 'rb') as f:
        analyzer.analyze_audio(f)

metrics = analyzer.get_training_metrics()
dashboard = visualizer.create_metrics_dashboard(metrics, title="Voice Performance")
pio.write_html(dashboard, 'voice_dashboard.html')
```

---

## 📊 Streamlit Integration Example

```python
import streamlit as st
from voice_analytics import VoiceAnalyzer, VoiceVisualizer

analyzer = VoiceAnalyzer()
visualizer = VoiceVisualizer()

uploaded_file = st.file_uploader("Upload audio sample", type=['wav', 'mp3'])

if uploaded_file:
    st.audio(uploaded_file)
    metrics = analyzer.analyze_audio(uploaded_file)
    st.write("Analysis Results:", metrics)

    if metrics and 'error' not in metrics:
        patterns = analyzer.analyze_voice_patterns(uploaded_file.getvalue())
        fig_radar = visualizer.create_pattern_radar(patterns, title="Voice Pattern Analysis")
        st.plotly_chart(fig_radar, use_container_width=True)

        if 'text' in metrics:
            st.subheader("Transcribed Text")
            st.write(metrics['text'])
```

---

## 📄 License

This software is licensed under a proprietary license.  
See the [LICENSE](./LICENSE) file for full terms.
