Machine Learning

This reference covers 9 HTTP operations registered by the Akasha daemon. Call these paths on your instance base URL. See authentication, errors, and coverage before integrating.

POST /v1/ml/models/load

Ml models load

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — LoadModelRequest

struct LoadModelRequest {
    name: String,
    model_type: String,
    framework: String,
    path: Option<String>,
    data_b64: Option<String>,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({"id": id})

serde_json::json!({"id": id})

Errors and validation

Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:2650. Registration: akasha-daemon/src/main.rs:4556.

POST /v1/ml/models/unload

Ml models unload

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — UnloadModelRequest

struct UnloadModelRequest {
    id: String,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({"ok": true})

Errors and validation

Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:2685. Registration: akasha-daemon/src/main.rs:4557.

GET /v1/ml/models

Ml models list

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

No typed JSON, query, or path extractor is declared in the handler signature. Headers or request objects may still be consumed; the signature below is authoritative.

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({"models": db.ml_list_loaded_models()}),

Errors and validation

Directly referenced error variants: none in the handler body. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:2697. Registration: akasha-daemon/src/main.rs:4558.

POST /v1/ml/metrics

Ml metrics

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — MlMetricsRequest

struct MlMetricsRequest {
    model_id: String,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({"metrics": m})

Errors and validation

Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:2712. Registration: akasha-daemon/src/main.rs:4559.

POST /v1/ml/embed

Ml embed

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — EmbedRequest

struct EmbedRequest {
    text: String,
    /// When true, long text is automatically chunked and each chunk is
    /// embedded separately.  The response contains a `vectors` array instead
    /// of a single `vector`.
    #[serde(default)]
    chunk: bool,
    /// Optional per-request chunking overrides.
    chunking: Option<chunking::ChunkingConfig>,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({"vector": v, "chunks": 1})

serde_json::json!({
            "vectors": vectors,
            "chunks": chunks.len(),
        })

serde_json::json!({"vector": v})

Errors and validation

Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:2737. Registration: akasha-daemon/src/main.rs:4560.

POST /v1/ml/generate

Ml generate

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — MlGenerateRequest

struct MlGenerateRequest {
    model_id: String,
    prompt: String,
    max_tokens: Option<usize>,
    temperature: Option<f32>,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({"text": text})

Errors and validation

Directly referenced error variants: InvalidRequest, ServiceDisabled. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:2829. Registration: akasha-daemon/src/main.rs:4561.

POST /v1/ml/tokenizers/load

Ml tokenizer load

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — MlTokenizerLoadReq

struct MlTokenizerLoadReq {
    model_id: String,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({"ok": true})

Errors and validation

Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:2862. Registration: akasha-daemon/src/main.rs:4562.

POST /v1/ml/train/supervised

Ml train supervised http

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — MlTrainSupervisedReq

struct MlTrainSupervisedReq {
    model_name: String,
    input_dim: usize,
    num_classes: usize,
    samples: Vec<MlSupervisedSample>,
    #[serde(default)]
    params: MlTrainingParams,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({
        "model_id": info.id,
        "name": info.name,
        "version": info.version,
        "metrics": info.metrics,
    })

Errors and validation

Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:2972. Registration: akasha-daemon/src/main.rs:4563.

POST /v1/ml/train/hrm

Ml train hrm http

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

Json — MlTrainHrmReq

struct MlTrainHrmReq {
    domain: String,
    dataspace: String,
    primitive_keyspace: String,
    checkpoint_name: String,
    #[serde(default)]
    reservoir_id: Option<String>,
    #[serde(default)]
    epochs: Option<usize>,
    #[serde(default)]
    batch_size: Option<usize>,
    model_config: serde_json::Value,
    training_config: serde_json::Value,
    #[serde(default)]
    #[allow(dead_code)]
    inputs: Option<Vec<serde_json::Value>>,
    #[serde(default)]
    #[allow(dead_code)]
    targets: Option<Vec<serde_json::Value>>,
}

Response

Declared return: Result<impl IntoResponse, DaemonError>

The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.

serde_json::json!({"status": "ok"})

Errors and validation

Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:3025. Registration: akasha-daemon/src/main.rs:4564.