Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/leytox/timemarker
Try engaging way to explore historical information about specific locations across different time periods, with AI-generated narratives providing the storytelling element.
https://github.com/leytox/timemarker
ai history llama nextjs openstreetmap shadcn tailwind
Last synced: 1 day ago
JSON representation
Try engaging way to explore historical information about specific locations across different time periods, with AI-generated narratives providing the storytelling element.
- Host: GitHub
- URL: https://github.com/leytox/timemarker
- Owner: Leytox
- Created: 2024-11-05T18:31:10.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-05T21:08:03.000Z (about 2 months ago)
- Last Synced: 2024-12-22T01:55:57.905Z (5 days ago)
- Topics: ai, history, llama, nextjs, openstreetmap, shadcn, tailwind
- Language: TypeScript
- Homepage: https://time-marker.vercel.app
- Size: 169 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TimeMarker
TimeMarker is an interactive web application that lets users explore historical and speculative future narratives based on specific geographical locations and time periods. Built with Next.js and enhanced with modern UI components, it combines temporal and spatial data to generate unique historical perspectives.
## Features
- **Interactive Time Selection**: Choose any year using an intuitive year picker
- **Location Selection**: Multiple ways to select locations:
- Manual coordinate input
- Current location detection
- Interactive map picker with OpenStreetMap integration
- **AI-Powered Historical Narratives**: Generates detailed historical or futuristic accounts based on selected time and location
- **Responsive Design**: Fully functional across desktop and mobile devices
- **Dark/Light Theme**: Supports system preference and manual theme switching
## Technology Stack
- **Framework**: Next.js 14
- **Styling**: Tailwind CSS
- **UI Components**: shadcn/ui
- **Maps**: Leaflet with React-Leaflet
- **Font**: Geist Font Family
- **AI Integration**: Groq API with Llama3 model
- **Form Handling**: React Hook Form with Zod validation
## Getting Started
1. Clone the repository
2. Install dependencies:
```bash
npm install
```
3. Run the development server:
```bash
npm run dev
```
4. Open [http://localhost:3000](http://localhost:3000) in your browser
## Usage
1. Navigate to the main page
2. Click "Get Started"
3. Select a year you want to explore
4. Choose a location using one of the available methods:
- Enter coordinates manually
- Use your current location
- Pick a location on the map
5. Click "Start Journey" to generate a historical narrative
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
All rights reserved. Created by [Leytox](https://github.com/Leytox)
## Support Ukraine 🇺🇦
This project stands with Ukraine. Visit [Stand With Ukraine](https://standwithukraine.com.ua) to learn more.
```