jbilcke-hf's picture
jbilcke-hf HF staff
update the README to warn about Docker issues on Mac
51c9556
metadata
title: Template Node CTransformers Express
emoji: 🐍
colorFrom: yellow
colorTo: green
sdk: docker
pinned: false
app_port: 7860

A minimalist Docker space to help people getting started with Node, CTransformers (through Pythonia), Express and TypeScript. Ready to be used in a Hugging Face Space.

Demo

https://huggingface.co/spaces/jbilcke-hf/template-node-ctransformers-express

Installation

Prerequisites

CTransformers

This projects relies on CTransformers called through Pythonia.

To install ctransformers:

pip install ctransformers
# or this, depending on your Python environment:
# pip3 install ctransformers

For GPU (CUDA) support set environment variable CT_CUBLAS=1 and install from source using:

CT_CUBLAS=1 pip install ctransformers --no-binary ctransformers
# or this, depending on your Python environment:
# CT_CUBLAS=1 pip3 install ctransformers --no-binary ctransformers

Building and run without Docker

nvm use
npm i
npm run start

Building and running with Docker

npm run docker

This script is a shortcut executing the following commands:

docker build -t template-node-ctransformers-express .
docker run -it -p 7860:7860 template-node-ctransformers-express

Attention! If you have a Mac, you may have trouble running the project on your machine.

You will see the following error message because Docker won't be able to use the pre-generated binaries for libctransformers:so:

πŸŒ‰ OSError: /home/user/.local/lib/python3.11/site-packages/ctransformers/lib/avx2/libctransformers.so: cannot open shared object file: No such file or directory]

However if you run your project on a Hugging Face space, you should be just fine :)

See this demo: https://huggingface.co/spaces/jbilcke-hf/template-node-ctransformers-express