Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
import { KtxDecoder } from "./ktx";
export class KTXTools{
constructor(){
this.ktxEncoder = null;
this.libktx = null;
this.unavailableReason = null;
// Kept as a promise so compress() can await the encoder instead of
// racing it, and so a missing libktx never becomes an unhandled
// rejection at import time.
this.ready = this.init();
}
async init() {
const canvasWebgl = document.createElement('canvas');
const gl = canvasWebgl.getContext('webgl'); // WebGL context is needed for KTX operations
if (!gl) {
this.unavailableReason = 'no WebGL context available for the KTX encoder';
return false;
}
if (typeof window.LIBKTX !== 'function') {
this.unavailableReason = 'libktx.js did not load (expected the LIBKTX global from /avatar-studio/ktx2/libktx.js)';
return false;
}
try {
const ktxEncoder = new KtxDecoder(gl, window.LIBKTX);
await ktxEncoder.init(gl, window.LIBKTX);
this.ktxEncoder = ktxEncoder;
this.libktx = ktxEncoder.libktx;
return true;
} catch (err) {
this.unavailableReason = `libktx failed to initialize: ${err?.message || err}`;
return false;
}
}
async compress(raw_data, width, height, comps, options = {}){
if (!(await this.ready)) {
throw new Error(`KTX2 compression is unavailable: ${this.unavailableReason}. Export again with KTX compression turned off.`);
}
const basisu_options = await new this.libktx.ktxBasisParams();
const userBasisuOptions = options;
basisu_options.uastc = userBasisuOptions.uastc !== undefined ? userBasisuOptions.uastc : false;
basisu_options.noSSE = userBasisuOptions.noSSE !== undefined ? userBasisuOptions.noSSE : false;
basisu_options.verbose = userBasisuOptions.verbose !== undefined ? userBasisuOptions.verbose : false;
basisu_options.normalMap = userBasisuOptions.normalMap !== undefined ? userBasisuOptions.normalMap : false;
basisu_options.compressionLevel = userBasisuOptions.compressionLevel !== undefined ? userBasisuOptions.compressionLevel : 1;
basisu_options.qualityLevel = userBasisuOptions.qualityLevel !== undefined ? userBasisuOptions.qualityLevel : 60;
//== ETC1S ==
basisu_options.maxEndpoints = userBasisuOptions.ETC1SmaxEndpoints !== undefined ?userBasisuOptions.ETC1SmaxEndpoints : 0;
basisu_options.endpointRDOThreshold = userBasisuOptions.ETC1SEndpointRdoThreshold !== undefined ? userBasisuOptions.ETC1SEndpointRdoThreshold : 1.25;
basisu_options.maxSelectors = userBasisuOptions.ETC1SMaxSelectors !== undefined ? userBasisuOptions.ETC1SMaxSelectors : 0;
basisu_options.selectorRDOThreshold = userBasisuOptions.ETC1SSelectorRdoThreshold !== undefined ? userBasisuOptions.ETC1SSelectorRdoThreshold : 1.25;
// basisu_options.normalMap = targetKTX2_ETC1S_normalMap;
// basisu_options.preSwizzle = false;
basisu_options.noEndpointRDO = userBasisuOptions.ETC1SNoEndpointRdo !== undefined ? userBasisuOptions.ETC1SNoEndpointRdo : false;
basisu_options.noSelectorRDO = userBasisuOptions.ETC1SNoSelectorRdo !== undefined ? userBasisuOptions.ETC1SNoSelectorRdo : false;
//== UASTC ==
basisu_options.uastcFlags = this.ktxEncoder.stringToUastcFlags(userBasisuOptions.uastcFlags);
basisu_options.uastcRDO = basisu_options.uastcRDO !== undefined ? basisu_options.uastcRDO : false;
basisu_options.uastcRDOQualityScalar = userBasisuOptions.uastcRDOQualityScalar !== undefined ? userBasisuOptions.uastcRDOQualityScalar : 1.0;
basisu_options.uastcRDODictSize = userBasisuOptions.uastcRDODictSize !== undefined ? userBasisuOptions.uastcRDOQualityScalar : 4096;
basisu_options.uastcRDOMaxSmoothBlockErrorScale = userBasisuOptions.uastcRDOMaxSmoothBlockErrorScale !== undefined? userBasisuOptions.uastcRDOMaxSmoothBlockErrorScale : 10.0;
basisu_options.uastcRDOMaxSmoothBlockStdDev = userBasisuOptions.uastcRDOMaxSmoothBlockStdDev !== undefined? userBasisuOptions.uastcRDOMaxSmoothBlockStdDev : 18.0;
basisu_options.uastcRDODontFavorSimplerModes = userBasisuOptions.uastcRDODontFavorSimplerModes !== undefined ? userBasisuOptions.uastcRDODontFavorSimplerModes : false;
// missing
//userBasisuOptions.ETC1SQualityLevel
options.basisu_options = basisu_options;
// supercmp_scheme
if (!Object.prototype.hasOwnProperty.call(options, 'supercmp_scheme')){
options.supercmp_scheme = this.libktx.SupercmpScheme.NONE;
}
else{
options.supercmp_scheme = this.ktxEncoder.stringToSupercmpScheme(options.supercmp_scheme);
}
// if (!options.hasOwnProperty('compression_level')) {
// options.compression_level = 18;
// }
return await this.ktxEncoder.compress(raw_data, width, height, comps, options);
}
}