Skip to content

Ches-ctrl/council-chatbot

Repository files navigation

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)
  • pnpm (install via npm install -g pnpm)

Local Development

# Clone the repository
git clone <YOUR_GIT_URL>

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

About

πŸ₯‡ Oxford AI Hack - Conversational AI for Local Councils

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •