Skip to main content

CustomChat

A chat app for your documents. Ask a question, follow the citations, and keep the conversation going. Configure the model, sources and look in your browser.

It starts in offline Demo mode, with no API key or paid calls. Demo uses built-in answers, not a live AI model.

CustomChat answering a question with sources in offline Demo mode

Install and start

With uv installed, run:

uvx customchat-app start --directory my-chat

The app opens in your browser. Your settings, documents and chats stay in my-chat. Press Ctrl+C to stop; run the same command from the same folder to return.

Without uv, use the one-command installer for macOS, Linux or Windows. It installs what it needs without changing your system Python. For pip, install customchat-app in a virtual environment with Python 3.10 or newer. The package named customchat on PyPI is a different project.

Configure

  1. Open Configuration. In Answers, choose a provider, model and any required key, then test the connection and save.
  2. Add your documents or web links. Choose which sources the chat should use.
  3. In Appearance, choose a look and adjust the title, colors and fonts.

For help, type in Find a setting or open Guide. Ask AI asks your selected model about settings and may cost money.

Build with AI drafts a setup from your description. Choose a provider and model first, describe the app, then review, validate and save the draft. Restart to apply it. Generated code does not run automatically. Model requests may cost money.

Build with AI describe step with an example prompt

Keep keys out of YAML and Git. Check sources for important answers; citations are not a guarantee of correctness.

Install options · Configuration reference · Hosting

MIT license. Harsh Kashyap and Shela Wu. Advisor: Dennis Shasha. Related project: Custom-Nerd.

Fetch and start the latest release (uv installed):

uvx --refresh customchat-app start --directory my-chat

For pip: python -m pip install --upgrade --no-cache-dir customchat-app, then python -m customchat start --directory my-chat.

Metadata

Release files for customchat-app 0.1.34

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for customchat-app 0.1.34
File Size Uploaded
customchat_app-0.1.34.tar.gz 9.3 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for customchat-app 0.1.34
File Interpreter ABI Platform
customchat_app-0.1.34-py3-none-any.whl Python 3 none any Details

Total release size: 18.6 MB

Release files / customchat_app-0.1.34.tar.gz

Download URL customchat_app-0.1.34.tar.gz
Size 9.3 MB
Tags Source
SHA-256 checksum
How to use checksums
a18b0466cfe0b2ba010fae456b92ff441b1d88e05d0840847a4c43c0da37ea16
BLAKE2b-256 checksum
How to use checksums
096e9e580bd9f81b5e660d92f5d223827c1567c6b73689b79410e8524896f5c9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release files / customchat_app-0.1.34-py3-none-any.whl

Download URL customchat_app-0.1.34-py3-none-any.whl
Size 9.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
951a0b2eca6e1cbc461e1124bd6355a3f486552f4ceebc00d3906f6687ed8049
BLAKE2b-256 checksum
How to use checksums
d3bfd69243098748a1cddee1d5dcd256d7d6dca3c5bf349bcc888b2eddf9b133
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page