git404hub

what is mcfish fr?

sean-stapleton-doyle/mcfish — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · developerComplexity · 3/5LicenseSetup · hard

tl;dr

McFish makes the Fish Speech text-to-speech AI run fast on Apple Silicon Macs. Type text and get spoken audio almost instantly, or clone a voice from a short audio clip.

vibe map

mindmap
  root((McFish))
    What it does
      Text to speech
      Voice cloning
      Streams audio fast
    Tech stack
      Python
      PyTorch
      Apple Metal
    Use cases
      Generate speech
      Clone voices
      Build audio apps
    Audience
      Mac developers
      AI researchers
    Setup
      Needs Apple Silicon
      11 GB model download
      uv tool required

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Generate spoken audio from text on an Apple Silicon Mac.

VIBE 2

Clone a specific voice by providing a 10 to 30 second reference clip.

VIBE 3

Run a local text-to-speech API server for development.

VIBE 4

Use the included web UI to interactively generate speech.

what's the stack?

PythonPyTorchApple Metal

how it stacks up fr

sean-stapleton-doyle/mcfish0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultyhardeasyhard
Complexity3/52/55/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires an Apple Silicon Mac and downloading about 11 GB of model weights.

Free for research and non-commercial use only, commercial use requires obtaining a separate license from Fish Audio.

in plain english

McFish is a modified version of Fish Speech, a text-to-speech system originally built by Fish Audio. The original software was designed to run on NVIDIA graphics cards, and it did not work well or at all on Mac computers. McFish adapts the system so it runs efficiently on Apple Silicon Macs, turning a tool that previously produced audio at roughly one twentieth of playback speed into one that can generate speech faster than real time. The core problem was speed. The original system ran at about 1.2 tokens per second on a Mac, but the model needs about 21.5 tokens per second to match real audio playback. That meant generating a sentence took roughly twelve seconds before any sound came out, and the entire utterance had to finish processing first. McFish brings generation speed up to between 12 and 23 tokens per second depending on the mode, and it streams audio in chunks so you hear the first sound after about 1.5 seconds instead of waiting for the full clip. The technical changes fall into three areas. First, memory bandwidth improvements: the software sizes its internal caches to the actual request rather than a fixed maximum, skips redundant computations, and offers an optional int8 mode using custom Metal code that reads half the data per token. Second, overhead reductions: the authors fused operations, moved certain checks from every token to every fourth token, and applied PyTorch compilation despite lingering bugs. Third, structural changes allow reusing cached data across text chunks and decoding audio in overlapping segments for faster streaming. Most changes produce bit-identical output, with minor deviations behind flags and validated by listening tests. To use McFish you need an Apple Silicon Mac and a tool called uv. You clone the repository, run a sync, download the model weights (about 11 GB), and then run a Python script with your text to generate a WAV file. You can also provide a 10 to 30 second reference clip to clone a specific voice. For maximum speed, you quantize the model once and run with a compile flag to hit roughly real-time generation. A web UI and API server are included. The project is for research and non-commercial use only, commercial use requires a separate license from Fish Audio. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
I have an Apple Silicon Mac. How do I install and run McFish to generate a WAV file from text using the command line?
prompt 2
Show me how to use McFish to clone a specific voice from a 15-second audio clip and generate speech with that cloned voice.
prompt 3
How do I quantize the McFish model and run it with the compile flag to get the fastest real-time speech generation on my Mac?
prompt 4
How do I start the McFish web UI and API server so I can generate speech from a browser?
prompt 5
What is the difference between the int8 mode and the default mode in McFish, and how do I enable int8 for faster generation?

Frequently asked questions

what is mcfish fr?

McFish makes the Fish Speech text-to-speech AI run fast on Apple Silicon Macs. Type text and get spoken audio almost instantly, or clone a voice from a short audio clip.

What language is mcfish written in?

Mainly Python. The stack also includes Python, PyTorch, Apple Metal.

What license does mcfish use?

Free for research and non-commercial use only, commercial use requires obtaining a separate license from Fish Audio.

How hard is mcfish to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is mcfish for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.