Chroma

Prerequisite

1. Download & Install Docker and Git

2. Clone Chroma's repository with your terminal

git clone https://github.com/chroma-core/chroma.git

1. Change directory path to your cloned Chroma

cd chroma

1. Run docker compose to build up Chroma image and container

docker compose up -d --build

1. If success, you will be able to see the docker images spun up:

Setup

Input	Description	Default
Document	Can be connected with nodes from Document Loader
Embeddings	Can be connected with nodes from Embeddings
Collection Name	Chroma collection name. Refer to here for naming convention
Chroma URL	Specify the URL of your chroma instance	http://localhost:8000

Additional

If you are running both Flowise and Chroma on Docker, there are additional steps involved.

1. Spin up Chroma docker first

docker compose up -d --build

1. Open docker-compose.yml in Flowise

cd Flowise && cd docker

1. Modify the file to:

version: '3.1'

services:
    flowise:
        image: flowiseai/flowise
        restart: always
        environment:
            - PORT=${PORT}
            - FLOWISE_USERNAME=${FLOWISE_USERNAME}
            - FLOWISE_PASSWORD=${FLOWISE_PASSWORD}
            - DEBUG=${DEBUG}
            - DATABASE_PATH=${DATABASE_PATH}
            - APIKEY_PATH=${APIKEY_PATH}
            - SECRETKEY_PATH=${SECRETKEY_PATH}
            - FLOWISE_SECRETKEY_OVERWRITE=${FLOWISE_SECRETKEY_OVERWRITE}
            - LOG_PATH=${LOG_PATH}
            - LOG_LEVEL=${LOG_LEVEL}
            - EXECUTION_MODE=${EXECUTION_MODE}
        ports:
            - '${PORT}:${PORT}'
        volumes:
            - ~/.flowise:/root/.flowise
        networks:
            - flowise_net
        command: /bin/sh -c "sleep 3; flowise start"
networks:
    flowise_net:
        name: chroma_net
        external: true

1. Spin up Flowise docker image

docker compose up -d

1. On the Chroma URL, for Windows and MacOS Operating Systems specify http://host.docker.internal:8000. For Linux based systems the default docker gateway should be used since host.docker.internal is not available: http://172.17.0.1:8000

Resources

• LangChain JS Chroma

• Chroma Getting Started