xocialize commited on
Commit
e765a28
·
verified ·
1 Parent(s): 71f2fe3

Card: per-tier Swift example, the pre-quantised loader line, every tier loads four bundles (planner choices listed)

Browse files
Files changed (1) hide show
  1. README.md +5 -3
README.md CHANGED
@@ -36,8 +36,10 @@ layout conversion (key prefix / conv layout / weight-norm folding) — the conve
36
 
37
  ## Use
38
 
39
- This bundle is one of the four (five, with the lite planner) weight sources of the Swift package
40
- [xocialize/mlx-ace-step-swift](https://github.com/xocialize/mlx-ace-step-swift), which runs ACE-Step 1.5 on Apple Silicon through
 
 
41
  [MLX Swift](https://github.com/ml-explore/mlx-swift) and plugs into [MLXEngine](https://github.com/xocialize/mlx-engine-swift) on the
42
  `music` capability (caption + lyrics → a 48 kHz stereo song; reference-audio timbre; cover / repaint / extend of a source clip;
43
  LRC timestamps). The package's `ACEStepConfiguration` names these repos and the engine materialises them; the parity gates
@@ -45,7 +47,7 @@ against the upstream oracle (fp32, TF32 off) are recorded in the package's `MEAS
45
 
46
  ```swift
47
  let engine = MLXServeEngine()
48
- let id = try await engine.register(ACEStepPackage.registration, configuration: ACEStepConfiguration(quant: .bf16))
49
  try await engine.prepare(.music, package: id)
50
  let song = try await engine.run(MusicRequest(caption: "…", lyrics: "[Verse]\n…", durationSeconds: 120, seed: 7), package: id)
51
  ```
 
36
 
37
  ## Use
38
 
39
+ Every tier of the Swift package loads four bundles — the turbo DiT, one planner, the text encoder and the VAE — and this bundle
40
+ is one of them. The planner choices: `ACE-Step-1.5-planner-1.7B-8bit` for `.int8` (the default), `-4bit` for `.int4`, `-bf16` for
41
+ `.bf16` / `.fp32`, and `ACE-Step-1.5-planner-0.6B-bf16` for the lite planner on any tier. The package,
42
+ [xocialize/mlx-ace-step-swift](https://github.com/xocialize/mlx-ace-step-swift), runs ACE-Step 1.5 on Apple Silicon through
43
  [MLX Swift](https://github.com/ml-explore/mlx-swift) and plugs into [MLXEngine](https://github.com/xocialize/mlx-engine-swift) on the
44
  `music` capability (caption + lyrics → a 48 kHz stereo song; reference-audio timbre; cover / repaint / extend of a source clip;
45
  LRC timestamps). The package's `ACEStepConfiguration` names these repos and the engine materialises them; the parity gates
 
47
 
48
  ```swift
49
  let engine = MLXServeEngine()
50
+ let id = try await engine.register(ACEStepPackage.registration, configuration: ACEStepConfiguration()) // the .int8 default
51
  try await engine.prepare(.music, package: id)
52
  let song = try await engine.run(MusicRequest(caption: "…", lyrics: "[Verse]\n…", durationSeconds: 120, seed: 7), package: id)
53
  ```