chroma-core / chroma-core/chroma

[Feature Request]: chroma browse fails with "Failed to load records" when using v2 API on local server

Open
#7,269 0 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
Rust
Stars
29.3k
Forks
2.5k
Avg merge
1d 4h
Merged PRs (30d)
38

Description

### Describe the problem

Environment:
Chroma version: 1.4.4
CLI version: 1.4.4
Steps to reproduce:
Start a local Chroma server at localhost:8000
Run chroma browse --local
Observe: (Error) Failed to load records
Expected behavior: chroma browse should successfully load and display records from the collection using the v2 API (/api/v2/...).
Actual behavior: The CLI fails to load records. Direct v2 API calls via curl work correctly:
curl http://localhost:8000/api/v2/tenants/default_tenant/databases/default_database/collections//get

Additional context: The v2 API endpoints work correctly via curl, suggesting the CLI is not using the correct API version or endpoint format.

Image

Image

### Describe the proposed solution

Update the chroma browse CLI command to use the v2 API endpoints (/api/v2/...) when communicating with a local Chroma server. Specifically:

- Replace any v1 API calls with the equivalent v2 endpoints, e.g.: /api/v2/tenants/{tenant}/databases/{database}/collections/{id}/get
- Default to default_tenant and default_database when no tenant/database flags are provided
- Optionally, add --tenant and --database flags to allow users to specify custom values

### Alternatives considered

_No response_

### Importance

nice to have

### Additional Information

_No response_

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by locating the chroma browse CLI command and tracing how its --local mode builds requests to the Chroma server. Compare those requests with the documented /api/v2/tenants/{tenant}/databases/{database}/collections/{id}/get endpoint, then run the command against a local server and verify that records load; check custom tenant and database handling if flags are added.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
api, cli, database
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
64/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.