Skip to content

Make videos on the computer you already own. FreeVideo runs MiniMax H3 in as little as 8 GB of VRAM and 16 GB of RAM, and adapts its acceleration path to your hardware.

Add ModelScope source for encoder

Bowen Xue8bc73df69c98
diff --git a/freevideo_engine/dependencies.json b/freevideo_engine/dependencies.json
index 74dadd1..e8f3363 100644
--- a/freevideo_engine/dependencies.json
+++ b/freevideo_engine/dependencies.json
@@ -36,6 +36,13 @@
"encoder_revision": "d6aa5dfc669a749dc9364a36f3b6d4d1545a53e8",
"encoder_file": "text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors",
"encoder_sha256": "35a88d51044231fe332301d7a62aa81e3f2cba62febeb446e2c1e3e0ef76f2c6",
+ "encoder_modelscope": {
+ "repo": "LAAASSS/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors",
+ "revision": "526349f8fbb32e5fcb0cb5e9235b30f45f1e1482",
+ "hf_revision": "d6aa5dfc669a749dc9364a36f3b6d4d1545a53e8",
+ "file": "qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors",
+ "probe_file": "qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors"
+ },
"edge_modelscope": {
"repo": "OpenVDN/vdn-minimax-h3-edge",
"revision": "c247caf6f9f54fab9240e78fc7e0ec233016e47a",
diff --git a/freevideo_engine/download_settings.py b/freevideo_engine/download_settings.py
index a06fb78..6f0e431 100644
--- a/freevideo_engine/download_settings.py
+++ b/freevideo_engine/download_settings.py
@@ -12,7 +12,7 @@ from .proxy import MODES
CHOICES = ('auto', 'official', 'hf-mirror', 'modelscope')
# Shown as is by the Tk window and mapped to Chinese by the setup page.
SPEED_TEST_FAILED = 'The speed test did not finish. Click "Test source speeds".'
-FAMILIES = ('edge-models', 'vdn-models', 'models', 'image-models')
+FAMILIES = ('edge-models', 'vdn-models', 'encoder-models', 'models', 'image-models')
def speed_text(row, zh=False):
@@ -117,8 +117,8 @@ def order(network, family, names):
measured=list(dict.fromkeys(r['id'] for r in rows if r.get('ok') and r.get('id') in names))
names=measured+[n for n in names if n not in measured]
selected=value['source']
- # ModelScope has no verified encoder mapping. That family retains its
- # supported HF sources instead of constructing an invalid download URL.
+ # A source selection only applies to families with a supported route; the
+ # remaining families keep their measured and configured HF source order.
return [selected]+[n for n in names if n!=selected] if family in FAMILIES and selected in names else names
diff --git a/freevideo_engine/download_settings_ui.py b/freevideo_engine/download_settings_ui.py
index 2424b6b..d30cc03 100644
--- a/freevideo_engine/download_settings_ui.py
+++ b/freevideo_engine/download_settings_ui.py
@@ -129,6 +129,7 @@ class DownloadSettings:
self.rendered = measured
self.speeds.delete(*self.speeds.get_children())
families = {'edge-models': self.t('Video model', '视频模型'), 'vdn-models': self.t('Decoder', '解码器'),
+ 'encoder-models': self.t('Text encoder', '文本编码器'),
'models': self.t('Prompt model', '提示词模型'), 'pypi': self.t('Python packages', 'Python 依赖'),
'github': self.t('Tools', '安装工具'), 'git': 'Git', 'cuda': 'CUDA'}
for family, rows in (measured or {}).get('sources', {}).items():
diff --git a/freevideo_engine/launcher_session.py b/freevideo_engine/launcher_session.py
index a3149e7..f71147f 100644
--- a/freevideo_engine/launcher_session.py
+++ b/freevideo_engine/launcher_session.py
@@ -2242,6 +2242,7 @@ class Session:
for group, entries in probe.get('sources', {}).items():
for entry in entries:
names = {'edge-models': ('Video model', '视频模型'), 'vdn-models': ('Decoder', '解码器'),
+ 'encoder-models': ('Text encoder', '文本编码器'),
'image-models': NAMES['image'],
'models': NAMES['text'], 'pypi': ('Python packages', 'Python 依赖'),
'github': ('Tools', '安装工具'), 'git': ('Git', 'Git'), 'cuda': ('CUDA', 'CUDA')}
diff --git a/freevideo_engine/model_transfer.py b/freevideo_engine/model_transfer.py
index ab7b42e..a818676 100644
--- a/freevideo_engine/model_transfer.py
+++ b/freevideo_engine/model_transfer.py
@@ -255,8 +255,11 @@ def sdk_worker(request):
ms_parallel(_download,network.model_url(row,source),target,row['bytes'],headers,None,
[Callback(row['file'],row['bytes'])])
else:
+ remote_file = mirror.get('file', row['file'])
+ local_dir = (stage / Path(row['file']).parent
+ if Path(remote_file).parent != Path(row['file']).parent else stage)
HubApi(endpoint=network.source_url(mirror['family'], source), token='').downloader.download_file(
- mirror['repo'], 'model', row['file'], revision=mirror['revision'], local_dir=stage,
+ mirror['repo'], 'model', remote_file, revision=mirror['revision'], local_dir=local_dir,
file_size=row['bytes'], expected_sha256=None, progress_callbacks=[Callback])
finally:
_download.requests.get = original_get
diff --git a/freevideo_engine/network.py b/freevideo_engine/network.py
index 9926709..0c59af3 100644
--- a/freevideo_engine/network.py
+++ b/freevideo_engine/network.py
@@ -36,6 +36,8 @@ SOURCES = {
'modelscope': 'https://www.modelscope.cn'},
'edge-models': {'official': 'https://huggingface.co', 'hf-mirror': 'https://hf-mirror.com',
'modelscope': 'https://www.modelscope.cn'},
+ 'encoder-models': {'official': 'https://huggingface.co', 'hf-mirror': 'https://hf-mirror.com',
+ 'modelscope': 'https://www.modelscope.cn'},
'image-models': {'official': 'https://huggingface.co', 'hf-mirror': 'https://hf-mirror.com',
'modelscope': 'https://www.modelscope.cn'},
'github': {'official': 'https://github.com', 'ghfast': 'https://ghfast.top/https://github.com'},
@@ -69,6 +71,7 @@ def proxy_environment(environ=None):
def configured_source(family, env):
names = {'pypi': ('UV_DEFAULT_INDEX', 'UV_INDEX_URL', 'PIP_INDEX_URL'),
'models': ('HF_ENDPOINT',), 'vdn-models': ('HF_ENDPOINT',), 'edge-models': ('HF_ENDPOINT',),
+ 'encoder-models': ('HF_ENDPOINT',),
'github': ('FREEVIDEO_GITHUB_MIRROR',)}.get(family, ())
return next((env[k].rstrip('/') for k in names if env.get(k)), None)
@@ -94,7 +97,12 @@ def modelscope_mapping(row, spec=None):
"""Return only a published, verified HF-to-ModelScope revision pair."""
settings = model_spec(spec)
# A ModelScope commit is not a Hugging Face commit. Only the verified pair
- # shares paths/content; an encoder or a future HF pin needs its own route.
+ # shares content; unrelated or newer HF pins must keep using Hugging Face.
+ encoder = settings.get('encoder_modelscope', {})
+ if (encoder and row['repo'] == settings.get('encoder_repo') and
+ row['revision'] == settings.get('encoder_revision') == encoder.get('hf_revision') and
+ row.get('file') == settings.get('encoder_file')):
+ return dict(encoder, family='encoder-models')
for prefix in ('vdn', 'edge'):
mirror = settings.get(prefix + '_modelscope', {})
if (mirror and row['repo'] == settings.get(prefix + '_repo', mirror['repo']) and
@@ -123,7 +131,7 @@ def model_url(row, name, env=None, *, spec=None):
if not mirror:
raise ValueError('No verified ModelScope mapping for this model revision')
return (source_url(mirror['family'], name, env) + '/api/v1/models/' + quote(mirror['repo'], safe='/') +
- '/repo?' + urlencode({'Revision': mirror['revision'], 'FilePath': row['file']}))
+ '/repo?' + urlencode({'Revision': mirror['revision'], 'FilePath': mirror.get('file', row['file'])}))
return (source_url('models', name, env) + '/' + quote(row['repo'], safe='/') +
'/resolve/' + quote(row['revision'], safe='') + '/' + quote(row['file'], safe='/'))
@@ -309,11 +317,15 @@ def probe(family, name, spec, versions, timeout, env, *, measure_speed=False):
elif family == 'image-models':
from .image_gen.image_pack import rows
url = model_url(rows()[0], name, env)
- elif family in ('vdn-models', 'edge-models'):
+ elif family in ('vdn-models', 'edge-models', 'encoder-models'):
settings = spec['models']
- mirror = settings[family.split('-')[0] + '_modelscope']
- url = model_url({'repo': mirror['repo'], 'revision': mirror['hf_revision'],
- 'file': mirror['probe_file']}, name, env, spec=spec)
+ if family == 'encoder-models':
+ url = model_url({'repo': settings['encoder_repo'], 'revision': settings['encoder_revision'],
+ 'file': settings['encoder_file']}, name, env, spec=spec)
+ else:
+ mirror = settings[family.split('-')[0] + '_modelscope']
+ url = model_url({'repo': mirror['repo'], 'revision': mirror['hf_revision'],
+ 'file': mirror['probe_file']}, name, env, spec=spec)
elif family == 'github':
url = versions.get('github_probe_url', versions['uv']['url']).replace(SOURCES['github']['official'], base, 1)
elif family == 'git':
@@ -347,7 +359,7 @@ def probe(family, name, spec, versions, timeout, env, *, measure_speed=False):
component = versions['cuda_toolkits']['13.0']['components']['cuda_cudart']
url = base + '/' + component['relative_path']
headers = ()
- if (family in ('models', 'vdn-models', 'edge-models', 'image-models') and name == 'official'
+ if (family in ('models', 'vdn-models', 'edge-models', 'encoder-models', 'image-models') and name == 'official'
and urlsplit(url).scheme == 'https' and urlsplit(url).netloc == 'huggingface.co'):
token = env.get('HF_TOKEN') or env.get('HUGGING_FACE_HUB_TOKEN')
if token:
@@ -404,6 +416,8 @@ def plan(spec, versions, layout='unified', *, mode='auto', timeout=5, offline=Fa
proxy_configured = proxy.configured(env)
git_keys = [] if offline or model_only or not git_available else proxy.git_proxy_keys(env)
families = ['pypi', 'models', 'vdn-models', 'image-models', 'github', 'git', 'cuda']
+ if spec['models'].get('encoder_modelscope'):
+ families.insert(2, 'encoder-models')
if spec['models'].get('edge_modelscope'):
families.insert(3, 'edge-models')
if versions.get('target_system') in ('Windows', 'Darwin'):
@@ -414,7 +428,7 @@ def plan(spec, versions, layout='unified', *, mode='auto', timeout=5, offline=Fa
if family not in families:
families.append(family)
if model_only:
- families=[family for family in families if family in ('models','vdn-models','edge-models','image-models')]
+ families=[family for family in families if family in ('models','encoder-models','vdn-models','edge-models','image-models')]
selections, jobs = {}, []
for family in families:
group = 'torch' if family.startswith('torch-') else 'github' if family == 'git' else family
@@ -1073,7 +1087,7 @@ def download_here(candidates, path, expected, progress=None, *, network=None, en
if updating and progress:
progress(path.stat().st_size, size or 0, last_rate)
- model = category in ('models', 'vdn-models', 'edge-models', 'image-models')
+ model = category in ('models', 'vdn-models', 'edge-models', 'encoder-models', 'image-models')
stall_seconds = stall_seconds if stall_seconds is not None else 120 if model else 20
def matches(candidate, source='local'):
@@ -1089,7 +1103,7 @@ def download_here(candidates, path, expected, progress=None, *, network=None, en
check()
if model:
report(done, total)
- matched = hash_file(candidate, algorithm, git_blob, discard_cache=category in ('models', 'vdn-models', 'image-models'),
+ matched = hash_file(candidate, algorithm, git_blob, discard_cache=category in ('models', 'vdn-models', 'encoder-models', 'image-models'),
progress=verification if model or check else None) == expected
if matched and verify is not None:
matched = verify(candidate)
diff --git a/freevideo_engine/terminal_ui.py b/freevideo_engine/terminal_ui.py
index e344a55..9204553 100644
--- a/freevideo_engine/terminal_ui.py
+++ b/freevideo_engine/terminal_ui.py
@@ -530,7 +530,7 @@ class LogProgress:
name=event.get('name') or model_download_name(event['file']).split(' · ')[0],
detail={'verify_model': 'Verify ', 'download_model': 'Download ',
'assemble_model': 'Assemble downloaded parts · '}[kind] + model_download_name(event['file']))
- elif kind == 'network' and event.get('category') in ('models', 'vdn-models', 'edge-models') and event.get('action') == 'attempt':
+ elif kind == 'network' and event.get('category') in ('models', 'vdn-models', 'edge-models', 'encoder-models') and event.get('action') == 'attempt':
self.model_backend = ''
self.model_source = {'modelscope': 'ModelScope', 'official': 'Hugging Face',
'hf-mirror': 'HF Mirror', 'user': 'Custom source'}.get(event['source'], 'Model source')
@@ -566,7 +566,7 @@ class LogProgress:
update(done=0, total=0, rate=None, scope=action, unit='bytes', detail=detail)
if action in ('retry', 'route-retry'):
update(activity='resume', name='')
- elif kind == 'network' and event.get('category') in ('models', 'vdn-models', 'edge-models') and event.get('action') in ('fallback', 'verifying'):
+ elif kind == 'network' and event.get('category') in ('models', 'vdn-models', 'edge-models', 'encoder-models') and event.get('action') in ('fallback', 'verifying'):
action = event['action']
self.model_backend = ''
detail = ('Verify %s · ' % event.get('algorithm', 'integrity').upper() if action == 'verifying'
diff --git a/web/setup.js b/web/setup.js
index 2d860f1..9aba385 100644
--- a/web/setup.js
+++ b/web/setup.js
@@ -254,7 +254,7 @@ export async function openSetup() {
table.append(header);
for (const [family, rows] of Object.entries(measured.sources)) for (const row of rows) {
const tr = node('tr');
- const names = {'edge-models':t('Video model','视频模型'),'vdn-models':t('Decoder','解码器'),models:t('Prompt model','提示词模型'),pypi:t('Python packages','Python 依赖'),github:t('Tools','安装工具'),git:'Git',cuda:'CUDA'};
+ const names = {'edge-models':t('Video model','视频模型'),'vdn-models':t('Decoder','解码器'),'encoder-models':t('Text encoder','文本编码器'),models:t('Prompt model','提示词模型'),pypi:t('Python packages','Python 依赖'),github:t('Tools','安装工具'),git:'Git',cuda:'CUDA'};
if (family.startsWith('torch-')) names[family] = t('GPU packages','GPU 依赖');
const rate = row.bytes_per_second / 2**20;
const speed = !row.ok ? t('Unavailable','未连通') : row.speed_measured === false || !Number.isFinite(rate) || rate <= 0 ?