SOTA Open Source TTS
This report summarizes scanner evidence for fishaudio/fish-speech, a Python project with 32,994 GitHub stars. SynthScan examined 25,530 lines of code across 157 source files, recording 147 pattern matches distributed across 13 syntactic categories. The legacy adjusted pattern signal is 7.2 (Moderate pattern signal); it is not an authorship estimate.
Use the findings to ask whether maintainers can explain intent, verify dependencies, simplify unnecessary scaffolding, and focus review effort. Risk Payload v1 adds ownership, supply-chain, over-engineering, and review-effort vectors when available. These are prompts for human verification, not probabilities, security findings, or measured maintenance costs.
Use each vector to guide manual verification of the underlying findings.
Can maintainers explain intent, assumptions, and trade-offs? 64 finding(s).
Are imports declared and package/API names verified? 55 finding(s).
Are wrappers, guards, and repeated structures necessary? 59 finding(s).
Which changes need focused human review? 147 finding(s).
This chart tracks the legacy adjusted pattern score across scan runs. Changes can reflect source changes, scan coverage, or detector/scoring versions; they do not measure AI adoption or prove that a team refactored code. Compare runs only when their scoring versions are compatible. The dashed line tracks the raw pattern-hit count.
Groups findings by configured severity weight. Severity is not a confidence estimate, security rating, or proof that a package is missing. Verify imports against the project's manifests and inspect each finding in its local design context.
This horizontal bar chart shows where configured pattern scores accumulate across directories. Treat the bars as locations to inspect, not as evidence of authorship or code quality. Use the file-level findings to decide whether a directory needs a focused ownership, dependency, complexity, or review check.
The scanner identified 147 distinct pattern matches across 13 syntactic categories. Each entry below represents a discrete location in the source code where the engine recorded a detector match to inspect in context. Expand any category row to inspect the individual file paths, line numbers, code snippets, and the lexical context (CODE, COMMENT, or STRING) in which each match was detected.
Reading the findings table: The Severity column indicates the configured finding weight (CRITICAL / HIGH / MEDIUM / LOW). The Context column identifies whether the match occurred inside executable code, an inline comment, or a string literal — legacy comment-context matches receive a ×1.5 score weight. The ⚡ bolt icon marks clustered matches: three or more patterns within a 10-line window, each receiving an additional ×1.5 density multiplier under the legacy scoring model.
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tools/api_server.py | 10 | CODE | |
| LOW | tools/api_client.py | 2 | CODE | |
| LOW | tools/vqgan/extract_vq.py | 8 | CODE | |
| LOW | tools/server/model_utils.py | 2 | CODE | |
| LOW | tools/server/model_utils.py | 6 | CODE | |
| LOW | tools/server/views.py | 4 | CODE | |
| LOW | tools/server/views.py | 27 | CODE | |
| LOW | tools/llama/merge_lora.py | 1 | CODE | |
| LOW | tools/llama/merge_lora.py | 6 | CODE | |
| LOW | tools/llama/merge_lora.py | 13 | CODE | |
| LOW | tools/llama/build_dataset.py | 5 | CODE | |
| LOW | fish_speech/conversation.py | 8 | CODE | |
| LOW | fish_speech/tokenizer.py | 1 | CODE | |
| LOW | fish_speech/tokenizer.py | 3 | CODE | |
| LOW | fish_speech/tokenizer.py | 10 | CODE | |
| LOW | fish_speech/train.py | 4 | CODE | |
| LOW | fish_speech/train.py | 13 | CODE | |
| LOW | fish_speech/callbacks/grad_norm.py | 3 | CODE | |
| LOW | fish_speech/callbacks/__init__.py | 1 | CODE | |
| LOW | fish_speech/callbacks/__init__.py | 2 | CODE | |
| LOW | fish_speech/datasets/concat_repeat.py | 2 | CODE | |
| LOW | fish_speech/datasets/semantic.py | 3 | CODE | |
| LOW | fish_speech/datasets/semantic.py | 9 | CODE | |
| LOW | fish_speech/datasets/semantic.py | 12 | CODE | |
| LOW | fish_speech/datasets/semantic.py | 13 | CODE | |
| LOW | fish_speech/datasets/semantic.py | 615 | CODE | |
| LOW | fish_speech/utils/__init__.py | 1 | CODE | |
| LOW | fish_speech/utils/__init__.py | 2 | CODE | |
| LOW | fish_speech/utils/__init__.py | 3 | CODE | |
| LOW | fish_speech/utils/__init__.py | 4 | CODE | |
| LOW | fish_speech/utils/__init__.py | 4 | CODE | |
| LOW | fish_speech/utils/__init__.py | 5 | CODE | |
| LOW | fish_speech/utils/__init__.py | 6 | CODE | |
| LOW | fish_speech/utils/__init__.py | 7 | CODE | |
| LOW | fish_speech/utils/__init__.py | 7 | CODE | |
| LOW | fish_speech/utils/__init__.py | 8 | CODE | |
| LOW | fish_speech/utils/__init__.py | 8 | CODE | |
| LOW | fish_speech/utils/__init__.py | 8 | CODE | |
| LOW | fish_speech/utils/__init__.py | 8 | CODE | |
| LOW | fish_speech/utils/spectrogram.py | 4 | CODE | |
| LOW | fish_speech/utils/schema.py | 2 | CODE | |
| LOW | fish_speech/utils/schema.py | 3 | CODE | |
| LOW | fish_speech/utils/schema.py | 4 | CODE | |
| LOW | fish_speech/utils/schema.py | 7 | CODE | |
| LOW | fish_speech/utils/schema.py | 12 | CODE | |
| LOW | fish_speech/utils/schema.py | 12 | CODE | |
| LOW | fish_speech/models/dac/modded_dac.py | 8 | CODE | |
| LOW | fish_speech/models/text2semantic/lit_module.py | 1 | CODE | |
| LOW | fish_speech/models/text2semantic/inference.py | 37 | CODE | |
| LOW | fish_speech/models/text2semantic/inference.py | 37 | CODE | |
| LOW | fish_speech/text/__init__.py | 1 | CODE | |
| LOW | fish_speech/i18n/__init__.py | 1 | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| MEDIUM | tools/run_webui.py | 76 | # Create the inference engine | COMMENT |
| MEDIUM | tools/vqgan/extract_vq.py | 23 | # This file is used to convert the audio files to text files using the Whisper model. | COMMENT |
| MEDIUM | tools/server/views.py | 235 | # Create a temporary file for the audio data | COMMENT |
| MEDIUM | fish_speech/tokenizer.py | 81 | # Create a lookup tensor to handle potential gaps in token IDs safely | COMMENT |
| MEDIUM | fish_speech/inference_engine/reference_loader.py | 36 | # Define the torchaudio backend | COMMENT |
| MEDIUM | fish_speech/inference_engine/__init__.py | 166 | # Create a queue to get the response | COMMENT |
| MEDIUM | fish_speech/i18n/scan.py | 55 | # Define the standard file name | COMMENT |
| MEDIUM | fish_speech/i18n/scan.py | 78 | # Define the standard file name | COMMENT |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tools/api_server.py | 109 | except Exception as exc: | CODE |
| LOW | tools/vqgan/create_train_split.py | 48 | except Exception as e: | CODE |
| LOW | tools/vqgan/extract_vq.py | 101 | except Exception as e: | CODE |
| LOW | tools/server/api_utils.py | 146 | except Exception as e: | CODE |
| LOW | tools/server/views.py | 108 | except Exception as e: | CODE |
| LOW | tools/server/views.py | 139 | except Exception as e: | CODE |
| LOW | tools/server/views.py | 201 | except Exception as e: | CODE |
| LOW | tools/server/views.py | 271 | except Exception as e: | CODE |
| LOW | tools/server/views.py | 310 | except Exception as e: | CODE |
| LOW | tools/server/views.py | 372 | except Exception as e: | CODE |
| LOW | tools/server/views.py | 480 | except Exception as e: | CODE |
| LOW | tools/llama/build_dataset.py | 40 | except Exception as e: | CODE |
| LOW | tools/llama/build_dataset.py | 87 | except Exception as e: | CODE |
| LOW | fish_speech/datasets/vqgan.py | 70 | except Exception as e: | CODE |
| MEDIUM | fish_speech/datasets/vqgan.py | 67 | def __getitem__(self, idx): | CODE |
| LOW | fish_speech/utils/utils.py | 72 | except Exception as ex: | CODE |
| LOW | fish_speech/utils/schema.py | 72 | except Exception: | CODE |
| LOW | fish_speech/models/text2semantic/llama.py | 527 | except Exception as e: | CODE |
| LOW | fish_speech/models/text2semantic/inference.py | 811 | except Exception as e: | CODE |
| LOW | fish_speech/inference_engine/reference_loader.py | 245 | except Exception as e: | CODE |
| LOW | fish_speech/inference_engine/reference_loader.py | 282 | except Exception as e: | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tools/server/model_utils.py | 55 | def cached_vqgan_batch_encode(model, audios: list[bytes]): | CODE |
| LOW | tools/server/api_utils.py | 79 | async def buffer_to_async_generator(buffer): | CODE |
| LOW | tools/llama/quantize.py | 22 | def dynamically_quantize_per_channel(x, quant_min, quant_max, target_dtype): | CODE |
| LOW | tools/llama/quantize.py | 101 | def group_quantize_tensor_from_qparams(w, scales, zeros, n_bit=4, groupsize=128): | CODE |
| LOW | tools/llama/quantize.py | 137 | def group_dequantize_tensor_from_qparams( | CODE |
| LOW | tools/llama/quantize.py | 168 | def create_quantized_state_dict(self) -> "StateDict": | CODE |
| LOW | tools/llama/quantize.py | 195 | def create_quantized_state_dict(self): | CODE |
| LOW | tools/llama/quantize.py | 310 | def create_quantized_state_dict(self): | CODE |
| LOW | fish_speech/scheduler.py | 4 | def get_cosine_schedule_with_warmup_lr_lambda( | CODE |
| LOW | fish_speech/scheduler.py | 28 | def get_constant_schedule_with_warmup_lr_lambda( | CODE |
| LOW | fish_speech/models/dac/modded_dac.py | 225 | def _compute_conformer_pos_scores(self, q: Tensor, seqlen: int) -> Tensor: | CODE |
| LOW | fish_speech/models/text2semantic/llama.py | 984 | def eq_scaled_dot_product_attention( | CODE |
| LOW | fish_speech/models/text2semantic/inference.py | 44 | def multinomial_sample_one_no_sync(probs_sort): | CODE |
| LOW | tests/test_visualization.py | 36 | def test_content_sequence_visualize_without_color(monkeypatch, capsys): | CODE |
| LOW | tests/test_visualization.py | 47 | def test_content_sequence_visualize_merges_audio_and_semantic_tokens( | CODE |
| LOW | tests/test_visualization.py | 73 | def test_conversation_visualize_forwards_options(monkeypatch): | CODE |
| LOW | tests/test_active_kv_attention.py | 90 | def test_attention_passes_only_active_kv_prefix_to_sdpa(self) -> None: | CODE |
| LOW | tests/test_active_kv_attention.py | 116 | def test_active_prefix_matches_masked_full_cache_with_tolerance(self) -> None: | CODE |
| LOW | tests/test_active_kv_attention.py | 201 | def test_prefill_first_decode_and_maximum_prefix(self) -> None: | CODE |
| LOW | tests/test_active_kv_attention.py | 322 | def test_real_decode_chain_preserves_greedy_tokens_and_distributions(self) -> None: | CODE |
| LOW | tests/test_active_kv_attention.py | 359 | def test_legacy_decode_callback_remains_supported(self) -> None: | CODE |
| LOW | tests/test_active_kv_attention.py | 408 | def test_compiled_decode_uses_one_dynamic_graph(self) -> None: | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tools/run_webui.py | 48 | # Check if MPS or CUDA is available | COMMENT |
| LOW | tools/vqgan/extract_vq.py | 37 | import torchaudio.io._load_audio_fileobj # Check if ffmpeg backend is available | CODE |
| LOW | tools/server/model_manager.py | 30 | # Check if MPS or CUDA is available | COMMENT |
| LOW | tools/server/views.py | 158 | # Check if the text is too long | COMMENT |
| LOW | tools/server/views.py | 165 | # Check if streaming is enabled | COMMENT |
| LOW | fish_speech/utils/schema.py | 69 | ): # Check if audio is a string (Base64) | CODE |
| LOW | fish_speech/inference_engine/reference_loader.py | 170 | # Check if directory contains at least one audio file and corresponding .lab file | COMMENT |
| LOW | fish_speech/inference_engine/reference_loader.py | 177 | # Check if corresponding .lab file exists for at least one audio file | COMMENT |
| LOW | fish_speech/inference_engine/reference_loader.py | 206 | # Check if reference already exists | COMMENT |
| LOW | fish_speech/inference_engine/reference_loader.py | 211 | # Check if audio file exists | COMMENT |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tools/vqgan/create_train_split.py | 20 | CODE | |
| LOW | tools/server/api_utils.py | 83 | CODE | |
| LOW | tools/webui/__init__.py | 9 | CODE | |
| LOW | tools/llama/quantize.py | 267 | CODE | |
| LOW | tools/llama/quantize.py | 310 | CODE | |
| LOW | fish_speech/content_sequence.py | 87 | CODE | |
| LOW | fish_speech/datasets/semantic.py | 118 | CODE | |
| LOW | fish_speech/datasets/semantic.py | 341 | CODE | |
| LOW | fish_speech/utils/logger.py | 27 | CODE | |
| LOW | fish_speech/utils/braceexpand.py | 105 | CODE | |
| LOW | fish_speech/utils/braceexpand.py | 156 | CODE | |
| LOW | fish_speech/models/text2semantic/llama.py | 500 | CODE | |
| LOW | fish_speech/models/text2semantic/inference.py | 861 | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| HIGH | tools/server/views.py | 70 | {"error": "WebUI not built. Run: cd awesome_webui && npm run build"}, | CODE |
| HIGH | tools/webui/__init__.py | 17 | js="() => {const params = new URLSearchParams(window.location.search);if (!params.has('__theme')) {params.se | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | fish_speech/datasets/semantic.py | 73 | CODE | |
| LOW | fish_speech/datasets/semantic.py | 283 | CODE | |
| LOW | fish_speech/datasets/semantic.py | 300 | CODE | |
| LOW | fish_speech/utils/spectrogram.py | 63 | CODE | |
| LOW | fish_speech/models/dac/modded_dac.py | 195 | CODE | |
| LOW | fish_speech/models/dac/modded_dac.py | 805 | CODE | |
| LOW | fish_speech/models/dac/rvq.py | 205 | CODE | |
| LOW | fish_speech/models/text2semantic/llama.py | 874 | CODE | |
| LOW | fish_speech/models/text2semantic/inference.py | 545 | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | fish_speech/tokenizer.py | 12 | logger = logging.getLogger(__name__) | CODE |
| LOW | fish_speech/callbacks/__init__.py | 4 | __all__ = ["GradNormMonitor", "GradAccumProgressBar"] | CODE |
| LOW | fish_speech/utils/__init__.py | 10 | __all__ = [ | CODE |
| LOW | fish_speech/utils/braceexpand.py | 12 | __all__ = ["braceexpand", "alphabet", "UnbalancedBracesError"] | CODE |
| LOW | fish_speech/text/__init__.py | 3 | __all__ = ["clean_text"] | CODE |
| LOW | fish_speech/i18n/__init__.py | 3 | __all__ = ["i18n"] | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| HIGH | tools/api_client.py | 133 | default="YOUR_API_KEY", | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| HIGH | fish_speech/utils/schema.py | 72 | except Exception: | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tools/llama/build_dataset.py | 65 | def run_task(task): | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | fish_speech/configs/base.yaml | 81 | # log_model: False # upload lightning ckpts | COMMENT |