ODS V3 Pre-Release: Public testing and refinement ahead of the official V3 launch. Turn your PC, Mac, or Linux box into a private AI server.
Python ai-agentsamdcomfyuidockerllama-cppllmlocal-ain8nnvidiaopen-webuiragself-hostedspeech-to-textstrix-halotext-to-speechworkflow-automation
"""Resolve the native transport with real Compose, without starting services."""
import json
import os
from pathlib import Path
import shutil
import subprocess
import tempfile
import unittest
ROOT = Path(__file__).resolve().parents[1]
@unittest.skipUnless(shutil.which('docker'), 'Docker CLI is required')
class NativeComposeTests(unittest.TestCase):
def setUp(self):
self.temp = tempfile.TemporaryDirectory(prefix='ods native compose ')
self.addCleanup(self.temp.cleanup)
self.base = Path(self.temp.name) / 'base.yaml'
services = {name: {'image': 'busybox:1.36.1'} for name in ('open-webui', 'dashboard-api')}
# Compare against explicit control values from this Compose version:
# v2 omits false, while newer serializers can omit true instead.
for flag in (False, True):
services['bind-' + str(flag).lower()] = {'image': 'busybox:1.36.1',
'volumes': [{'type': 'bind', 'source': self.temp.name,
'target': '/fixture', 'bind': {'create_host_path': flag}}]}
self.base.write_text(json.dumps({'services': services}))
self.env = {k: v for k, v in os.environ.items()
if not k.startswith(('PIXEL_', 'COMPOSE_'))}
self.env.update({
'PIXEL_NATIVE_UID': '732', 'PIXEL_INGRESS_GID': '81',
'PIXEL_NATIVE_INGRESS_IMAGE': 'example.invalid/pixel-node:test',
'PIXEL_NATIVE_CONFIG_PATH': self.temp.name + '/gateway config.json',
'PIXEL_NATIVE_CONFIG_SHA256': 'a' * 64,
'PIXEL_NATIVE_WORKSPACE': self.temp.name + '/workspace',
'PIXEL_NATIVE_GATEWAY_PORT': '19876',
'PIXEL_NATIVE_ACCESS_PORT': '19877',
'PIXEL_OPENWEBUI_KEY': 'test-only-edge-key',
'DASHBOARD_API_KEY': 'test-only-preview-key',
# Compose interpolates the shared Linux fragment before merging.
'PIXEL_INGRESS_RUNTIME_DIR': self.temp.name + '/unused-linux-runtime',
'PIXEL_PREVIEW_RUNTIME_DIR': self.temp.name + '/preview',
})
def resolve(self):
return subprocess.run([
'docker', 'compose', '--project-name', 'native-contract-test',
'--project-directory', str(ROOT), '--env-file', '/dev/null',
'-f', str(self.base),
'-f', str(ROOT / 'extensions/services/pixel-edge/compose.yaml.disabled'),
'-f', str(ROOT / 'installers/macos/pixel-native.compose.yaml.disabled'),
'config', '--format', 'json'], env=self.env, capture_output=True,
text=True, timeout=30)
def document(self):
result = self.resolve()
self.assertEqual(result.returncode, 0, result.stderr)
return json.loads(result.stdout)
def assert_no_host_path_creation(self, mount):
services = self.document()['services']
flags = [services[name]['volumes'][0].get('bind', {}).get('create_host_path')
for name in ('bind-false', 'bind-true')]
self.assertNotEqual(flags[0], flags[1], 'Compose did not distinguish explicit bind controls')
self.assertEqual(mount.get('bind', {}).get('create_host_path'), flags[0])
def test_native_identity_paths_and_health(self):
services = self.document()['services']
ingress = services['pixel-native-ingress']
self.assertEqual(ingress['user'], '732:81')
self.assertEqual(ingress['environment']['PIXEL_GATEWAY_PORT'], '19876')
self.assertEqual(ingress['environment']['PIXEL_GATEWAY_TRANSPORT'],
'docker-desktop-host')
mounts = {item['target']: item for item in ingress['volumes']}
config = mounts['/run/pixel-config']
self.assertEqual(config['type'], 'volume')
self.assertEqual(config['source'], 'pixel-native-config')
self.assertTrue(config['read_only'])
self.assertEqual(ingress['environment']['PIXEL_GATEWAY_TOKEN_FILE'], '/run/pixel-config/' + 'a' * 64 + '.json')
self.assertNotIn('/run/gateway.json', mounts)
self.assertNotIn('ports', ingress)
self.assertTrue(ingress['read_only'])
self.assertEqual(ingress['cap_drop'], ['ALL'])
self.assertIn('/runtime/pixel-ingress.sock', ingress['healthcheck']['test'][-1])
init = services['pixel-native-runtime-init']
self.assertEqual(init['command'], ['chown', '732:81', '/runtime'])
self.assertEqual(init['network_mode'], 'none')
self.assertEqual(init['cap_add'], ['CHOWN'])
def test_config_writer_is_explicit_offline_nonroot_and_private(self):
result = subprocess.run([
'docker', 'compose', '--profile', 'native-config-maintenance', '--project-name', 'native-contract-test',
'--project-directory', str(ROOT), '--env-file', '/dev/null', '-f', str(self.base),
'-f', str(ROOT / 'extensions/services/pixel-edge/compose.yaml.disabled'),
'-f', str(ROOT / 'installers/macos/pixel-native.compose.yaml.disabled'),
'config', '--format', 'json'], env=self.env, capture_output=True, text=True, timeout=30)
self.assertEqual(result.returncode, 0, result.stderr)
services = json.loads(result.stdout)['services']
writer = services['pixel-native-config-write']
self.assertEqual(writer['user'], '732:81')
self.assertEqual(writer['network_mode'], 'none')
self.assertEqual(writer['cap_drop'], ['ALL'])
self.assertTrue(writer['read_only'])
self.assertEqual(writer['labels']['org.osmantic.ods.native-config-source'], self.env['PIXEL_NATIVE_CONFIG_PATH'])
self.assertNotIn('pixel-native-config-write', self.document()['services'])
def test_shared_edge_contract_preserved(self):
services = self.document()['services']
edge = services['pixel-edge']
self.assertEqual(edge['container_name'], 'ods-pixel-edge')
self.assertEqual(edge['environment']['PIXEL_ACCESS_TRANSPORT'], 'docker-desktop-host')
self.assertEqual(edge['environment']['PIXEL_NATIVE_ACCESS_PORT'], '19877')
mounts = {item['target']: item for item in edge['volumes']}
self.assertEqual(len(mounts), 3)
self.assertEqual(mounts['/pixel-runtime']['type'], 'volume')
self.assertEqual(mounts['/pixel-runtime']['source'], 'pixel-native-runtime')
self.assertTrue(mounts['/pixel-runtime']['read_only'])
self.assertEqual(mounts['/pixel-transition-state']['source'], 'pixel-transition-state')
self.assertTrue(mounts['/pixel-preview-runtime']['read_only'])
self.assertEqual(mounts['/pixel-preview-runtime']['source'], 'pixel-native-preview-runtime')
self.assertEqual(edge['environment']['PIXEL_INGRESS_SOCKET'],
'/pixel-runtime/pixel-ingress.sock')
self.assertEqual(services['dashboard-api']['environment']['PIXEL_EDGE_URL'],
'http://pixel-edge:9595')
self.assertEqual(services['open-webui']['environment']['DEFAULT_MODELS'],
'portal/default')
def test_preview_has_only_workspace_read_access_and_loopback_publish(self):
service = self.document()['services']['pixel-workspace-preview']
self.assertEqual(service['user'], '732:81')
self.assertEqual(service['ports'][0]['host_ip'], '127.0.0.1')
self.assertEqual(service['command'][-2:], ['732', '9437'])
self.assertTrue(service['read_only'])
mounts = {item['target']: item for item in service['volumes']}
self.assertEqual(set(mounts), {'/workspace', '/previews', '/run/ods-pixel-preview'})
self.assertTrue(mounts['/workspace']['read_only'])
self.assert_no_host_path_creation(mounts['/workspace'])
def test_missing_native_prerequisites_fail_closed(self):
for key in ('PIXEL_NATIVE_UID', 'PIXEL_NATIVE_CONFIG_PATH',
'PIXEL_NATIVE_INGRESS_IMAGE', 'PIXEL_NATIVE_WORKSPACE'):
with self.subTest(key=key):
value = self.env.pop(key)
try:
result = self.resolve()
self.assertNotEqual(result.returncode, 0)
self.assertIn(key, result.stderr)
finally:
self.env[key] = value
if __name__ == '__main__':
unittest.main()