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 type { HoodNetwork } from 'hoodchain'
import type { Mode, RiskLimits } from './types.js'
import type { LlmClientConfig, LlmProvider } from './llm.js'
/** Fleet-wide configuration resolved from the environment. */
export interface FleetConfig {
network: HoodNetwork
rpcUrl: string | undefined
mode: Mode
/** Set true only when HOOD_TRADERS_LIVE=1 AND a key is present. */
hasWallet: boolean
privateKey: `0x${string}` | undefined
stockTokenEligible: boolean
fleetMaxDailySpendUsdg: number
dashboardPort: number
killFile: string
/** Path to the SQLite journal. */
dbPath: string
defaultLimits: RiskLimits
}
function num(name: string, fallback: number): number {
const raw = process.env[name]
if (raw === undefined || raw === '') return fallback
const n = Number(raw)
if (!Number.isFinite(n) || n < 0) {
throw new Error(`Env ${name}="${raw}" is not a non-negative number`)
}
return n
}
function bool(name: string, fallback: boolean): boolean {
const raw = process.env[name]
if (raw === undefined || raw === '') return fallback
return raw === '1' || raw.toLowerCase() === 'true' || raw.toLowerCase() === 'yes'
}
/**
* Resolve fleet configuration from the environment.
*
* Live mode is deliberately hard to enable by accident: it requires BOTH
* `HOOD_TRADERS_LIVE=1` and a `ROBINHOOD_CHAIN_PRIVATE_KEY`. Missing either one
* falls back to paper mode rather than erroring, so a mis-set flag can never
* silently spend real funds.
*/
export function loadFleetConfig(env: NodeJS.ProcessEnv = process.env): FleetConfig {
const network = (env.HOOD_NETWORK === 'testnet' ? 'testnet' : 'mainnet') as HoodNetwork
const wantLive = bool('HOOD_TRADERS_LIVE', false)
const privateKey = env.ROBINHOOD_CHAIN_PRIVATE_KEY as `0x${string}` | undefined
const hasKey = typeof privateKey === 'string' && /^0x[0-9a-fA-F]{64}$/.test(privateKey)
const mode: Mode = wantLive && hasKey ? 'live' : 'paper'
return {
network,
rpcUrl: env.HOOD_RPC_URL || undefined,
mode,
hasWallet: hasKey,
privateKey: hasKey ? privateKey : undefined,
stockTokenEligible: bool('HOOD_STOCK_TOKEN_ELIGIBLE', false),
fleetMaxDailySpendUsdg: num('FLEET_MAX_DAILY_SPEND_USDG', 250),
dashboardPort: num('DASHBOARD_PORT', 4670),
killFile: env.KILL_FILE || './KILL',
dbPath: env.HOOD_TRADERS_DB || './data/hood-traders.db',
defaultLimits: {
maxPositionUsdg: num('AGENT_MAX_POSITION_USDG', 50),
maxDailySpendUsdg: num('AGENT_MAX_DAILY_SPEND_USDG', 100),
maxSlippageBps: num('AGENT_MAX_SLIPPAGE_BPS', 100),
cooldownSeconds: num('AGENT_COOLDOWN_SECONDS', 60),
},
}
}
const LLM_PROVIDERS: readonly LlmProvider[] = ['anthropic', 'openai', 'groq', 'openrouter']
/**
* Resolve LLM config for {@link LlmStrategist} from the environment. Returns
* `null` when `HOOD_LLM_PROVIDER` or `HOOD_LLM_API_KEY` is unset — the
* strategy is optional and simply isn't added to the fleet in that case (see
* main.ts). Throws only when `HOOD_LLM_PROVIDER` is set to an unrecognized
* value, since that is very likely a typo the operator would want to know
* about immediately rather than silently running without the strategy.
*/
export function loadLlmConfig(env: NodeJS.ProcessEnv = process.env): LlmClientConfig | null {
const provider = env.HOOD_LLM_PROVIDER
const apiKey = env.HOOD_LLM_API_KEY
if (!provider && !apiKey) return null
if (!provider || !apiKey) {
throw new Error(
'hood-traders config.ts: HOOD_LLM_PROVIDER and HOOD_LLM_API_KEY must both be set to enable llm-strategist (or both left unset to disable it).',
)
}
if (!LLM_PROVIDERS.includes(provider as LlmProvider)) {
throw new Error(`hood-traders config.ts: HOOD_LLM_PROVIDER="${provider}" is not one of ${LLM_PROVIDERS.join(', ')}`)
}
return {
provider: provider as LlmProvider,
apiKey,
model: env.HOOD_LLM_MODEL || undefined,
timeoutMs: num('HOOD_LLM_TIMEOUT_MS', 9000),
}
}
/** Minimum LLM confidence required to convert a `buy` verdict into a trade. */
export function loadLlmMinConfidence(env: NodeJS.ProcessEnv = process.env): number {
return num('HOOD_LLM_MIN_CONFIDENCE', 0.6)
}