What it is
BasicChat is a website chatbot for small businesses. The owner pastes one script tag onto their site and a chat bubble appears. Visitors chat in real time, and the bot answers from the business details it was given. It can also book an appointment, look up business info, or hand the conversation to a person. One installation can serve many businesses, each with its own bot and settings. It was built over a single weekend.
How it works
- An admin signs in to the dashboard and creates a business.
- They configure that business's bot: name, instructions and behavior.
- They paste the script tag onto the business website.
- Visitors chat; the bot answers and can call its booking, info or hand-off tools.
- The admin reads past conversations in the dashboard.
What exists today
- A backend that serves many businesses from one deployment, with admin login
- An AI model answering each message, with a confidence score per answer
- Three tools: schedule an appointment, get business info, escalate to a human
- Live chat over WebSockets, with conversations saved
- A 13 KB chat widget with no dependencies that reconnects on its own
- A React dashboard for businesses, bot settings and conversation history
- A screenshot of a working chat from the first build
What isn't there yet
- The dashboard was not fully tested end to end
- The bot only knows what is typed into its settings; it can't read a website or documents
- Booking is a tool call, not tied to a real calendar
- No hosted version, no automated test suite and no sign-up flow
- Needs a database, a cache and an AI key to run, so there is no public demo
Under the hood
- Python FastAPI backend with async database access and migrations
- PostgreSQL for data, Redis as a cache
- Model access through OpenRouter, a service that routes to many AI models
- Containers and start scripts for the backend, widget and dashboard