Lance-ASR / README.md
NeuraCraft's picture
Update README.md
34aec2a verified
---
library_name: transformers
model_index:
- name: Lance ASR
results: []
tags:
- automatic-speech-recognition
- asr
- pytorch
- transformer
license: apache-2.0
---
# Lance ASR – The Foundation of Speech Intelligence
πŸš€ **Lance ASR** is a custom-built Automatic Speech Recognition (ASR) model designed for high-efficiency local and cloud inference. It utilizes a Transformer Encoder-Decoder architecture with convolutional subsampling for processing acoustic features.
## 🌟 Key Features
βœ… **Custom Architecture**: Not a Whisper clone; features a bespoke Conv1d-subsampling audio front-end.
βœ… **Hugging Face Compatible**: Fully integrates with `transformers` via `AutoModelForSeq2SeqLM`.
βœ… **Optimized for Precision**: Uses `bfloat16` for high-performance inference and training.
βœ… **Scalable Design**: Optimized for 768 hidden dims and 4 layers, balancing speed and accuracy.
βœ… **Seamless Tokenization**: Uses the `DWDMaiMai/tiktoken_cl100k_base` tokenizer for efficient text representation.
---
## πŸ“₯ Installation & Setup
Load Lance ASR directly from your local directory or the Hugging Face Hub:
```python
import torch
from transformers import AutoTokenizer, AutoFeatureExtractor, AutoModelForSeq2SeqLM
model_name = "NeuraCraft/Lance-ASR"
tokenizer = AutoTokenizer.from_pretrained(model_name)
feature_extractor = AutoFeatureExtractor.from_pretrained(model_name)
model = AutoModelForSeq2SeqLM.from_pretrained(model_name, torch_dtype=torch.bfloat16)
```
---
## πŸ›  Usage Example
Lance ASR can transcribe audio by processing log-mel spectrograms:
```python
# 1. Prepare audio features (e.g., from a .wav file)
# inputs = feature_extractor(audio_array, sampling_rate=16000, return_tensors="pt")
# 2. Generate transcription
model.eval()
with torch.no_grad():
generated_ids = model.generate(
inputs.input_features.to(torch.bfloat16),
max_new_tokens=250,
pad_token_id=tokenizer.eos_token_id
)
transcription = tokenizer.decode(generated_ids[0], skip_special_tokens=True)
print(f"Transcription: {transcription}")
```
---
πŸ“Š Performance & Evaluation
Lance ASR is currently in its early stages, and performance is being actively tested. Initial evaluations focus on:
πŸ”Ή **WER (Word Error Rate)** – Measures transcription accuracy
πŸ”Ή **CER (Character Error Rate)** – Measures character-level precision
πŸ”Ή **Inference Latency** – Optimized for real-time local processing
βœ… Planned Enhancements
πŸ”Ή Larger training datasets (e.g., Common Voice, LibriSpeech)
πŸ”Ή Advanced noise-robustness for real-world environments
πŸ”Ή Multilingual ASR support for global accessibility
---
πŸš€ Future Roadmap
Lance ASR is just getting started! The goal is to transform it into the core auditory component of an advanced AI assistant.
πŸ“… Planned Features:
πŸ”œ Real-time live transcription & streaming support
πŸ”œ Multi-speaker identification (Diarization)
πŸ”œ Integrated Voice Activity Detection (VAD)
πŸ”œ High-efficiency deployment for mobile and edge devices
---
πŸ— Development & Contributions
Lance ASR is being developed by **NeuraCraft**. Contributions, suggestions, and testing feedback are welcome!
πŸ“¬ Contact & Updates:
Developer: NeuraCraft
Project Status: 🚧 In Development
Follow for updates: Coming soon