Skip to main content

Generate per-session LoRA adapters for inference tasks using hypernetwork synthesis

Project description

Tessera Hypernetwork

Generate per-session LoRA adapters for inference tasks using hypernetwork synthesis.

Features

Metadata-to-LoRA: Generate adapters from structured user metadata (JSON) Text-to-LoRA: Generate adapters from natural language descriptions Doc-to-LoRA with SHINE: Generate adapters from document content using SHINE (ICML 2026) for long-context internalization FastAPI: Modern async Python web framework OpenAI-compatible API: Easy integration with existing tooling Installation pip install tessera-hypernetwork Quick Start

Commands

Generate:

From metadata (JSON string or file)

tessera generate
--from-metadata '{"task": "classification", "domain": "medical"}'
--base-model mistralai/Mistral-7B-Instruct-v0.2
--rank 16
--save ./adapter.safetensors

From text description:

tessera generate
--from-text "Medical diagnosis assistant"
--base-model mistralai/Mistral-7B-Instruct-v0.2
--rank 16
--save ./adapter.safetensors

From document:

tessera generate
--from-doc ./document.txt
--base-model mistralai/Mistral-7B-Instruct-v0.2
--rank 16
--save ./adapter.safetensors

'Generate' Sub-Commands:

--from-metadata: JSON metadata string or file path
--from-text: Natural language description
--from-doc: Document content or file path
--base-model: Base model identifier (default: mistralai/Mistral-7B-Instruct-v0.2)
--rank: LoRA rank (default: 16)
--save: Output path for safetensors file (required)
--mode: Generation mode: doc, metadata, or text (auto-inferred if not specified)
Serve

Start the hypernetwork server:

tessera serve --port 8000 --host 0.0.0.0 Options:

--port: Port to serve on (default: 8000)
--host: Host to bind to (default: 0.0.0.0)
--qdrant-url: Qdrant vector database URL (optional)
--workers: Number of worker processes (default: 1)
Health

Check server health status:

tessera health --url http://localhost:8000 Options:

--url: Server URL (default: http://localhost:8000)

List:

List available base models and their dimensions:

tessera list

LoRAX Adapter Management

Import, list, and unload adapters:

Import an adapter:

tessera lorax import-adapter
--path ./adapter.safetensors
--name my-adapter
--base-model mistralai/Mistral-7B-Instruct-v0.2
--server-url http://localhost:8000

List loaded adapters:

tessera lorax list-adapters --server-url http://localhost:8000

Unload an adapter:

tessera lorax unload --name my-adapter --server-url http://localhost:8000

API Endpoints

The hypernetwork service provides a FastAPI server with the following endpoints:

POST /v1/generate - Generate a LoRA adapter for a given prompt
GET /health - Health check endpoint
POST /v1/adapters - Import adapter safetensors
GET /v1/adapters - List loaded adapters
DELETE /v1/adapters/{name} - Unload adapter \

License
Apache-2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tessera_hypernetwork-1.0.8.tar.gz (44.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tessera_hypernetwork-1.0.8-py3-none-any.whl (52.5 kB view details)

Uploaded Python 3

File details

Details for the file tessera_hypernetwork-1.0.8.tar.gz.

File metadata

  • Download URL: tessera_hypernetwork-1.0.8.tar.gz
  • Upload date:
  • Size: 44.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for tessera_hypernetwork-1.0.8.tar.gz
Algorithm Hash digest
SHA256 1e9917806fd383a70a885c13d0f0a7571b4f21a326dbda7efcac41a45b296f17
MD5 ef5716c036aad799585e452037a2b192
BLAKE2b-256 181e36dc5e90cd86c91c819d9d78ec7ca7b3f94433837db3cf31a0a50a3b18c4

See more details on using hashes here.

File details

Details for the file tessera_hypernetwork-1.0.8-py3-none-any.whl.

File metadata

File hashes

Hashes for tessera_hypernetwork-1.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 996ac02bd98de655afbdb73f80d2c3ff1b1d4f623f51e41c6081f4702e78768c
MD5 bf0215788be6d053dfe6e133181add0e
BLAKE2b-256 588d8877e460b1bfd1252830a5b46be845064da21529dde07601927d9f3f8bb7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page