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.35

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.35
File Size Uploaded
customchat_app-0.1.35.tar.gz 9.3 MB Details

Built distribution (wheel)

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

Total release size: 18.6 MB

Release files / customchat_app-0.1.35.tar.gz

Download URL customchat_app-0.1.35.tar.gz
Size 9.3 MB
Tags Source
SHA-256 checksum
How to use checksums
824ea3aaa860e4c2c24ec5077e7890daac7b46a5faed3e36331fae3253771195
BLAKE2b-256 checksum
How to use checksums
29b8618656362b50353b8358c6a25ecc772125a2d72e8fed12bacc34b617928a
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 15, 2026.

Transparency log

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

Download URL customchat_app-0.1.35-py3-none-any.whl
Size 9.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
498bb53525fc1b9581172db3a41b74964085a5edf89a73ae27c75b1729c95a26
BLAKE2b-256 checksum
How to use checksums
eccae8d3fcc91fd023e1132106f1e24583176e7cc832b531b049c5ff65175543
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 15, 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