https://github.com/ches-ctrl/council-chatbot
🥇 Oxford AI Hack - Conversational AI for Local Councils
https://github.com/ches-ctrl/council-chatbot
hackathon hackathon-project
Last synced: 10 months ago
JSON representation
🥇 Oxford AI Hack - Conversational AI for Local Councils
- Host: GitHub
- URL: https://github.com/ches-ctrl/council-chatbot
- Owner: Ches-ctrl
- Created: 2025-05-17T10:57:36.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-18T12:59:19.000Z (about 1 year ago)
- Last Synced: 2025-06-04T21:52:13.827Z (about 1 year ago)
- Topics: hackathon, hackathon-project
- Language: TypeScript
- Homepage: https://civy.co.uk
- Size: 547 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Oxford City Council Chatbot
A modern, AI-powered chatbot interface that helps residents interact with Oxford City Council services. This project provides a user-friendly way to access council information and services, mirroring the official Oxford City Council website's functionality while offering an interactive chat experience.
## Features
- 🤖 AI-powered conversational interface for council services
- 📱 Responsive design that works on all devices
- 🔍 Quick access to council information and services
- 🎯 Accurate responses based on official council data
- 🎨 Modern UI with a familiar council website look and feel
## Project Overview
This chatbot serves as an alternative interface to the Oxford City Council website, allowing residents to:
- Get information about council services
- Find answers to common questions
- Navigate council resources through natural conversation
- Access council information in a more interactive way
## Technical Stack
This project is built with modern web technologies:
- ⚡️ Vite - Fast development and building
- 📘 TypeScript - Type-safe code
- ⚛️ React - User interface
- 🎨 shadcn-ui - Beautiful, accessible components
- 🎯 Tailwind CSS - Utility-first styling
## Getting Started
### Prerequisites
- Node.js (recommended to install via [nvm](https://github.com/nvm-sh/nvm#installing-and-updating))
- pnpm (install via `npm install -g pnpm`)
### Local Development
```sh
# Clone the repository
git clone
# Navigate to the project directory
cd local-authority-chatbot
# Install dependencies
pnpm install
# Start the development server
pnpm run dev
```
The development server will start at `http://localhost:5173` (or another port if 5173 is in use).
## Development Options
You can work on this project in several ways:
1. **Local Development**
- Use your preferred IDE
- Clone the repo and work locally
- Push changes to update the project
2. **GitHub Codespaces**
- Use the GitHub Codespaces environment
- Edit directly in the browser
- Commit and push changes when done
3. **Direct GitHub Editing**
- Edit files directly through GitHub's interface
- Make quick changes and commit them
## Deployment
The project can be deployed through Lovable:
1. Visit the [Lovable Project](https://lovable.dev/projects/c4489522-ba0d-4492-bbfc-2bda97563e89)
2. Click Share -> Publish
3. Optionally, set up a custom domain through Project > Settings > Domains
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is part of the Oxford Hackathon initiative and is subject to the terms of the hackathon's license agreement.
## Support
For support or questions about the chatbot, please contact the Oxford City Council or raise an issue in this repository.