aboutsummaryrefslogtreecommitdiff
path: root/embed_distributed.h
diff options
context:
space:
mode:
Diffstat (limited to 'embed_distributed.h')
-rw-r--r--embed_distributed.h47
1 files changed, 47 insertions, 0 deletions
diff --git a/embed_distributed.h b/embed_distributed.h
new file mode 100644
index 0000000..cd97147
--- /dev/null
+++ b/embed_distributed.h
@@ -0,0 +1,47 @@
+/*
+ * pplx_distributed.h - Stateless two-node layer-sharded inference.
+ */
+
+#ifndef PPLX_DISTRIBUTED_H
+#define PPLX_DISTRIBUTED_H
+
+#include "pplx_embed.h"
+
+typedef struct pplx_dist_client pplx_dist_client_t;
+
+typedef struct {
+ int mlx_quantize_bits;
+ int mlx_quantize_group_size;
+ int activation_bits; /* 0 defaults to fp32; supported: 32, 16 */
+} pplx_dist_options_t;
+
+/*
+ * Open a coordinator-side connection. The coordinator owns layers
+ * [0, local_layer_end); the remote worker must own [local_layer_end, N).
+ */
+pplx_dist_client_t *pplx_dist_client_open(const char *model_dir,
+ const char *host, int port,
+ int local_layer_end, int use_mlx);
+pplx_dist_client_t *pplx_dist_client_open_with_options(
+ const char *model_dir, const char *host, int port,
+ int local_layer_end, int use_mlx, const pplx_dist_options_t *opts);
+void pplx_dist_client_free(pplx_dist_client_t *client);
+
+const pplx_config_t *pplx_dist_client_config(const pplx_dist_client_t *client);
+
+int pplx_dist_client_embed_batch(pplx_dist_client_t *client,
+ const pplx_input_t *inputs, int batch,
+ float *out_embeddings);
+
+/*
+ * Run a final-stage worker until the process is terminated. The worker owns
+ * [layer_start, layer_end), and layer_end must be the model's final layer.
+ */
+int pplx_dist_run_worker(const char *model_dir, const char *host, int port,
+ int layer_start, int layer_end, int use_mlx);
+int pplx_dist_run_worker_with_options(
+ const char *model_dir, const char *host, int port,
+ int layer_start, int layer_end, int use_mlx,
+ const pplx_dist_options_t *opts);
+
+#endif /* PPLX_DISTRIBUTED_H */