Quick Start

npm install @harchos/sdk

import { HarchOS } from '@harchos/sdk';

const client = await HarchOS.create({
  apiKey: process.env.HARCHOS_API_KEY,
  region: 'morocco',
  sovereignty: 'strict',
  carbonAware: true,
});

const model = await client.models.register({
  name: 'my-llama-model',
  framework: 'pytorch',
  artifact: './model.pt',
  sovereignty: 'strict',
});

console.log(`Model registered: ${model.id}`);

const endpoint = await client.models.deploy(model.id, {
  gpu: 'H100',
  count: 2,
  hub: 'auto',           // Let THINK choose the optimal hub
  schedule: 'carbon-optimal',
  autoScale: {
    min: 1,
    max: 8,
    targetLatency: '100ms',
  },
});

console.log(`Endpoint live at: ${endpoint.url}`);

const result = await client.inference.run(endpoint.id, {
  input: 'Explain the HarchOS SENSE-THINK-ACT architecture',
  maxTokens: 512,
  temperature: 0.7,
});

console.log(result.output);
console.log(`Latency: ${result.latencyMs}ms`);
console.log(`Energy: ${result.energyWh}Wh (source: ${result.energySource})`);