GithubHelp home page GithubHelp logo

gltanaka / city-hub Goto Github PK

View Code? Open in Web Editor NEW

This project forked from colinalexander/city-hub

0.0 0.0 0.0 4.48 MB

AI-powered conversational assistant that makes it easy for residents and visitors to access information about San Francisco's city services and resources. Leveraging advanced language models and knowledge graphs, CityHub provides interactive, personalized guidance to help users navigate the complex landscape of local government.

License: MIT License

JavaScript 2.57% Python 66.03% TypeScript 20.30% CSS 7.46% HTML 2.76% Dockerfile 0.88%

city-hub's Introduction

CITY•HUB

CityHub is an AI-powered conversational assistant designed to help residents and visitors easily access information about San Francisco's city services and resources. By leveraging advanced language models like Meta's Llama 3 and knowledge graphs, CityHub provides interactive, personalized guidance to help users navigate the complex landscape of local government.

Project documents

Installation

To run CityHub locally, follow these steps:

  1. Clone the repository
git clone https://github.com/yourusername/city-hub.git
  1. Create and activate virtual environment Create your project folder. Then create your virtual environment and activate it.
cd my/project/root/folder
git clone [email protected]:colinalexander/city-hub.git
cd city-link
python3 -m venv .venv
source .venv/bin/activate
  1. Install dependencies
pip install -r requirements.txt
  1. Set up the necessary environment variables
cp .env-example .env
# EDIT NEW .env FILE AND ENTER VALID API KEYS WHERE REQUIRED
  1. Run the application:
TBD
  1. Open your browser and navigate to [http://localhost:5000] to start chatting with CityHub.

Usage

To interact with CityHub, simply type your question or request in the chat interface. CityHub will process your input and provide a relevant, informative response. You can ask follow-up questions, request clarifications, or explore related topics as needed. Some example queries:

  • "How do I apply for a residential parking permit?"
  • "What are the recycling guidelines in San Francisco?"
  • "What's the best way to get from the Castro to the Ferry Building using public transportation?"

CityHub will guide you through the process, provide step-by-step instructions, and offer personalized recommendations based on your needs.

Sample output

Here's an example of a conversation with CityHub:

User: How can I reserve a picnic area in Golden Gate Park?
CityHub: To reserve a picnic area in Golden Gate Park, you'll need to contact the San Francisco Recreation and Parks Department. Reservations can be made online, by phone, or in person. You'll need to provide the date, time, location, and number of people in your party. There is a fee for reservations, which varies based on the size of the picnic area. Shall I assist you with finding the reservation website?

User: Yes, please provide the link.
CityHub: Certainly! You can reserve a picnic area in Golden Gate Park by visiting the San Francisco Recreation and Parks Department website at https://sfrecpark.org/permits-and-reservations/picnic-areas/. From there, you can select your desired location, date, and time, and complete the online reservation form. Let me know if you have any other questions!

Open issues

  • Expand CityHub's knowledge base to cover more city services and resources
  • Improve the natural language understanding capabilities to handle more complex queries
  • Integrate with more data sources to provide real-time information (e.g., transit schedules, event calendars)
  • Enhance the user interface with visual elements and multimedia content
  • Implement multi-language support to serve San Francisco's diverse population
  • Expand to other cities!

FAQs

Q: How is CityHub different from Google?
A: CityHub offers a more personalized, interactive, and efficient experience compared to using a search engine like Google. While Google is a powerful tool for general information searching, CityHub offers a more specialized, user-friendly, and efficient experience tailored specifically for navigating San Francisco's city services and resources.

  • Conversational Interface:
    CityHub provides a natural, dialogue-based interface that allows users to ask questions and receive responses in a conversational manner. This makes it easier for users to find the information they need without having to sift through search results and web pages.
  • Personalized Guidance:
    CityHub can provide step-by-step instructions, recommendations, and context-specific advice based on the user's individual needs and questions. This level of personalization is difficult to achieve with a generic search engine.
  • Curated Knowledge Base:
    CityHub's knowledge base is specifically curated for San Francisco city services and resources, ensuring that users receive accurate, relevant, and up-to-date information. With Google, users may have to navigate through multiple websites to find the information they need.
  • Efficient Information Retrieval:
    By leveraging advanced language models and knowledge graphs, CityHub can quickly understand the user's intent and provide concise, targeted responses. This saves users time and effort compared to manually searching through Google results.
  • Interactive Follow-up:
    CityHub can engage in multi-turn conversations, allowing users to ask follow-up questions, request clarifications, and explore related topics seamlessly. This interactive nature makes it easier for users to find the information they need without having to start new searches.

Q: Is CityHub an official service provided by the City of San Francisco?
A: No, CityHub is an independent project developed by a team of AI enthusiasts and is not affiliated with the San Francisco government.

Q: How does CityHub protect user privacy?
A: CityHub does not store any personally identifiable information from user interactions. All conversations are processed anonymously and are not linked to individual users.

Q: Can CityHub help me with issues related to private businesses or organizations?
A: No, CityHub's knowledge base is focused on San Francisco's public services and resources. For inquiries related to private entities, please contact the relevant business or organization directly.

Q: How can I contribute to the development of CityHub?
A: We welcome contributions from the community! Please check our contributing guidelines for more information on how to get involved.

Q: Who can I contact for more information about CityHub?
A: If you have any questions, suggestions, or feedback, please open an issue on our GitHub repository or contact the project maintainers at [email protected].

Tech stack

city-hub's People

Contributors

colinalexander avatar jpzhangvincent avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.