Rocket.Chat Trip Helper

Standing in an unfamiliar place, unsure of what's going on around you, can take the fun out of exploring. The AI Travel Assistant turns that uncertainty into discovery. Just upload a photo from your trip to Rocket.Chat, and the app identifies your location, finds nearby events in real time, and delivers a clear, friendly summary. No need to search the web or guess what's nearby.

🚀 Features

• Photo-Based Discovery – Upload a photo from your surroundings to get local context and suggestions.
• Multi-Modal Image Understanding – Uses an advanced LLM to identify locations, landmarks, or venues from images.
• Live Event Fetching – Dynamically retrieves up-to-date local events and happenings using internet-connected tools.
• Interest-Aware Suggestions – Considers user context and preferences to surface relevant recommendations.
• Friendly AI Summaries – Delivers helpful, natural-language summaries of nearby events or places.
• Fail-Safe Responses – If the app is unsure, it avoids giving incorrect or speculative information.

⚙️ Installation

1. Have a Rocket.Chat server ready. If you don't have a server, see this guide.
2. Install the Rocket.Chat Apps Engline CLI.

     npm install -g @rocket.chat/apps-cli
   

   Verify if the CLI has been installed

   rc-apps -v
   # @rocket.chat/apps-cli/1.4.0 darwin-x64 node-v10.15.3
   

3. Clone the GitHub Repository

   git clone https://github.com/RocketChat/Apps.Trip.Helper.git

4. Navigate to the repository

   cd Apps.Trip.Helper

5. Install app dependencies

  cd trip-helper && npm install

6. To install private Rocket.Chat Apps on your server, it must be in development mode. Enable Apps development mode by navigating to Administration > General > Apps and turn on "Enable development mode".
7. Deploy the app to the server

rc-apps deploy --url <server_url> --username <username> --password <password>

• If you are running server locally, server_url is http://localhost:3000. If you are running in another port, change the 3000 to the appropriate port.
• username is the username of your admin user.
• password is the password of your admin user.
8. Open the App, by navigating to Administration > Marketplace > Private Apps. You should see the app listed there. Click on the App name to open the app.

🧑‍💻 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue. Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feat/AmazingFeature)
3. Commit your Changes (git commit -m 'feat: adds some amazing feature')
4. Push to the Branch (git push origin feat/AmazingFeature)
5. Open a Pull Request

📚 Resources

Here are some links to examples and documentation:

• Rocket.Chat Apps TypeScript Definitions Documentation
• Rocket.Chat Apps TypeScript Definitions Repository
• Demo Apps
  • DemoApp
  • GithubApp
• Community Forums
  • App Requests
  • App Guides
  • #rocketchat-apps on Open.Rocket.Chat