feat: implement zero-config system with Node.js 22 compatibility
- Add comprehensive zero-config preset system (production, development, minimal) - Implement intelligent auto-configuration for models and storage - Add Node.js version enforcement for ONNX Runtime stability - Force single-threaded ONNX operations to prevent V8 HandleScope crashes - Create extensible configuration architecture - Add 14 distributed system presets for enterprise deployments - Include detailed documentation and migration guides BREAKING CHANGE: Now requires Node.js 22.x LTS for optimal stability
This commit is contained in:
parent
4d60384755
commit
5f862bad98
20 changed files with 3718 additions and 71 deletions
81
src/utils/nodeVersionCheck.ts
Normal file
81
src/utils/nodeVersionCheck.ts
Normal file
|
|
@ -0,0 +1,81 @@
|
|||
/**
|
||||
* Node.js Version Compatibility Check
|
||||
*
|
||||
* Brainy requires Node.js 22.x LTS for maximum stability with ONNX Runtime.
|
||||
* This prevents V8 HandleScope locking issues in worker threads.
|
||||
*/
|
||||
|
||||
export interface VersionInfo {
|
||||
current: string
|
||||
major: number
|
||||
isSupported: boolean
|
||||
recommendation: string
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if the current Node.js version is supported
|
||||
*/
|
||||
export function checkNodeVersion(): VersionInfo {
|
||||
const nodeVersion = process.version
|
||||
const majorVersion = parseInt(nodeVersion.split('.')[0].substring(1))
|
||||
|
||||
const versionInfo: VersionInfo = {
|
||||
current: nodeVersion,
|
||||
major: majorVersion,
|
||||
isSupported: majorVersion === 22,
|
||||
recommendation: 'Node.js 22.x LTS'
|
||||
}
|
||||
|
||||
return versionInfo
|
||||
}
|
||||
|
||||
/**
|
||||
* Enforce Node.js version requirement with helpful error messaging
|
||||
*/
|
||||
export function enforceNodeVersion(): void {
|
||||
const versionInfo = checkNodeVersion()
|
||||
|
||||
if (!versionInfo.isSupported) {
|
||||
const errorMessage = [
|
||||
'🚨 BRAINY COMPATIBILITY ERROR',
|
||||
'━'.repeat(50),
|
||||
`❌ Current Node.js: ${versionInfo.current}`,
|
||||
`✅ Required: ${versionInfo.recommendation}`,
|
||||
'',
|
||||
'💡 Quick Fix:',
|
||||
' nvm install 22 && nvm use 22',
|
||||
' npm install',
|
||||
'',
|
||||
'📖 Why Node.js 22?',
|
||||
' • Maximum ONNX Runtime stability',
|
||||
' • Prevents V8 threading crashes',
|
||||
' • Optimal zero-config performance',
|
||||
'',
|
||||
'🔗 More info: https://github.com/soulcraftlabs/brainy#node-version',
|
||||
'━'.repeat(50)
|
||||
].join('\n')
|
||||
|
||||
throw new Error(errorMessage)
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Soft warning for version issues (non-blocking)
|
||||
*/
|
||||
export function warnNodeVersion(): boolean {
|
||||
const versionInfo = checkNodeVersion()
|
||||
|
||||
if (!versionInfo.isSupported) {
|
||||
console.warn([
|
||||
'⚠️ BRAINY VERSION WARNING',
|
||||
` Current: ${versionInfo.current}`,
|
||||
` Recommended: ${versionInfo.recommendation}`,
|
||||
' Consider upgrading for best stability',
|
||||
''
|
||||
].join('\n'))
|
||||
|
||||
return false
|
||||
}
|
||||
|
||||
return true
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue