{"_id":"@arelis-ai/governance-providers-huggingface","name":"@arelis-ai/governance-providers-huggingface","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@arelis-ai/governance-providers-huggingface","version":"1.0.0","description":"Arelis SDK provider adapter for Hugging Face Inference API and Dedicated Endpoints","license":"UNLICENSED","author":{"name":"Arelis"},"homepage":"https://github.com/arelis/arelis-sdk#readme","repository":{"type":"git","url":"git+https://github.com/arelis/arelis-sdk.git","directory":"packages/providers-huggingface"},"bugs":{"url":"https://github.com/arelis/arelis-sdk/issues"},"keywords":["arelis","sdk","huggingface","provider","llm"],"type":"module","main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"dependencies":{"@huggingface/inference":"^4.13.11","@arelis-ai/governance-models":"1.0.0","@arelis-ai/governance-providers-shared":"1.0.0"},"devDependencies":{"@prisma/client":"^5.10.0","@types/node":"^20.11.0","tsup":"^8.0.0","typescript":"^5.4.0","vitest":"^1.2.0","@arelis-ai/governance-audit":"1.0.0","@arelis-ai/governance-storage-postgres":"1.0.0"},"peerDependencies":{"typescript":">=5.4.0"},"peerDependenciesMeta":{"typescript":{"optional":true}},"engines":{"node":">=20.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"scripts":{"build":"tsup","dev":"tsup --watch","lint":"eslint src --ext .ts","lint:fix":"eslint src --ext .ts --fix","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","typecheck":"tsc --noEmit","clean":"rm -rf dist coverage"},"_id":"@arelis-ai/governance-providers-huggingface@1.0.0","_integrity":"sha512-+UcluE3LH/mbreSmUrDXdKMdxCIqZ6lF6FQ/KijIOfhpKMRZjhZP4zrkNnlhYKurmfn2SAICJVUi/wvw28PL3A==","_resolved":"/tmp/34ac0cef3d1d279d9b51b11b3ad7638d/arelis-ai-governance-providers-huggingface-1.0.0.tgz","_from":"file:arelis-ai-governance-providers-huggingface-1.0.0.tgz","_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-+UcluE3LH/mbreSmUrDXdKMdxCIqZ6lF6FQ/KijIOfhpKMRZjhZP4zrkNnlhYKurmfn2SAICJVUi/wvw28PL3A==","shasum":"eb7022b77a140a80a69e63c583f6c0cb12fa8a58","tarball":"https://registry.npmjs.org/@arelis-ai/governance-providers-huggingface/-/governance-providers-huggingface-1.0.0.tgz","fileCount":9,"unpackedSize":141347,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC6TMYC5Jf1oOaze+8kSkMfOkyLfIGSuuJhIUwNy3poCgIgWmZPFPFqyJ/gMAS6g7V9j/wtdg0CBtx5iBkRBGGq9YQ="}]},"_npmUser":{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"},"directories":{},"maintainers":[{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/governance-providers-huggingface_1.0.0_1771423351727_0.29477635265609825"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-18T14:02:31.598Z","1.0.0":"2026-02-18T14:02:31.884Z","modified":"2026-02-18T14:02:32.107Z"},"maintainers":[{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"}],"description":"Arelis SDK provider adapter for Hugging Face Inference API and Dedicated Endpoints","homepage":"https://github.com/arelis/arelis-sdk#readme","keywords":["arelis","sdk","huggingface","provider","llm"],"repository":{"type":"git","url":"git+https://github.com/arelis/arelis-sdk.git","directory":"packages/providers-huggingface"},"author":{"name":"Arelis"},"bugs":{"url":"https://github.com/arelis/arelis-sdk/issues"},"license":"UNLICENSED","readme":"# @arelis-ai/governance-providers-huggingface\n\nHugging Face Inference API + Dedicated Endpoints provider adapter for Arelis.\n\n## Install\n\n```bash\npnpm add @arelis-ai/governance-providers-huggingface\n```\n\n## Usage (Inference API)\n\n```ts\nimport {\n  createArelisClient,\n  createModelRegistry,\n  createAllowAllEngine,\n  createConsoleSink,\n} from '@arelis-ai/arelis-governance-sdk';\nimport { HuggingFaceProvider } from '@arelis-ai/governance-providers-huggingface';\n\nconst provider = new HuggingFaceProvider(\n  {\n    token: process.env.HF_TOKEN,\n    apiType: 'inference',\n  },\n  ['meta-llama/Llama-3-8b-instruct']\n);\n\nconst registry = createModelRegistry();\nregistry.register(provider);\n\nconst client = createArelisClient({\n  modelRegistry: registry,\n  policyEngine: createAllowAllEngine(),\n  auditSink: createConsoleSink(),\n});\n\nconst result = await client.models.generate({\n  model: 'meta-llama/Llama-3-8b-instruct',\n  request: {\n    model: 'meta-llama/Llama-3-8b-instruct',\n    messages: [{ role: 'user', content: 'Hello HF' }],\n  },\n  context: {\n    org: { id: 'org_1' },\n    actor: { type: 'human', id: 'user_1' },\n    purpose: 'testing',\n    environment: 'dev',\n  },\n});\n\nconsole.log(result.output.content);\n```\n\n## Usage (OpenAI-compatible endpoint)\n\n```ts\nconst provider = new HuggingFaceProvider(\n  {\n    token: process.env.HF_TOKEN,\n    endpoint: 'https://your-endpoint.huggingface.cloud',\n    apiType: 'openai',\n  },\n  ['tgi-openai']\n);\n```\n\n## Notes\n\n- `apiType: 'openai'` enables streaming, tool calls, and multimodal inputs.\n- `apiType: 'inference'` uses the standard Inference API and returns text only.\n","readmeFilename":"README.md","_rev":"1-5315f2cca6d0d4e6c056cd794af25ad9"}