{"id":22882284,"url":"https://github.com/wenzhenl/wikitimeline","last_synced_at":"2025-10-15T03:43:42.731Z","repository":{"id":277495511,"uuid":"899429159","full_name":"wenzhenl/wikitimeline","owner":"wenzhenl","description":"WikiTimeline: Transform Wikipedia articles into interactive timelines where you can compare historical figures/events and discover surprising connections","archived":false,"fork":false,"pushed_at":"2025-05-05T12:03:10.000Z","size":66523,"stargazers_count":48,"open_issues_count":18,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-08T03:06:10.130Z","etag":null,"topics":["ai","chronology","education","history","timeline","visualization","wikidata","wikipedia"],"latest_commit_sha":null,"homepage":"https://wiki-timeline.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wenzhenl.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["wenzhenl"]}},"created_at":"2024-12-06T08:49:28.000Z","updated_at":"2025-04-26T05:21:20.000Z","dependencies_parsed_at":"2025-03-01T01:25:05.541Z","dependency_job_id":"326909e8-af19-475d-ac85-b827fbb38859","html_url":"https://github.com/wenzhenl/wikitimeline","commit_stats":null,"previous_names":["wenzhenl/wikitimeline"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wenzhenl%2Fwikitimeline","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wenzhenl%2Fwikitimeline/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wenzhenl%2Fwikitimeline/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wenzhenl%2Fwikitimeline/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wenzhenl","download_url":"https://codeload.github.com/wenzhenl/wikitimeline/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252989949,"owners_count":21836667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chronology","education","history","timeline","visualization","wikidata","wikipedia"],"created_at":"2024-12-13T18:16:42.184Z","updated_at":"2025-10-05T15:56:34.781Z","avatar_url":"https://github.com/wenzhenl.png","language":"TypeScript","funding_links":["https://github.com/sponsors/wenzhenl"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003e🌟 WikiTimeline\u003c/h1\u003e\n  \u003cp\u003eTransform Wikipedia articles into beautiful, interactive timelines powered by AI\u003c/p\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://wiki-timeline.com/timeline/Nikola_Tesla%7CThomas_Edison\"\u003eLive Demo\u003c/a\u003e •\n    \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n    \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e •\n    \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n## Architecture\nCan be found with [deepwiki/wikitimeline](https://deepwiki.com/wenzhenl/wikitimeline)\n\n## ✨ Features\n\n- 🔄 **Instant Conversion**: Transform any Wikipedia article into a timeline in seconds\n- 🤖 **AI-Powered**: Utilizes Google Gemini to extract and organize chronological events\n- 📱 **Responsive Design**: Beautiful interface that works on all devices\n- 🌓 **Dark Mode**: Seamless experience in both light and dark themes\n- 🔄 **Multi-Timeline**: Compare multiple timelines side by side\n- 🎯 **Interactive**: Zoom, scroll, and explore events interactively\n\n## 🚀 Installation\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/wenzhenl/wikitimeline.git\ncd wikitimeline\n```\n\n2. Install dependencies:\n\n```bash\nnpm install\n```\n\n3. Set up environment variables:\n\n```bash\ncp .env.example .env.development.local\n```\n\n4. Configure your environment variables:\n\n   - Get a Gemini API key from [Google AI Studio](https://makersuite.google.com/app/apikey)\n   - Set up Vercel KV storage:\n     1. Install Vercel CLI: `npm i -g vercel`\n     2. Link your project: `vercel link`\n     3. Create a KV storage in [Vercel Dashboard](https://vercel.com/dashboard)\n     4. Connect KV to your project\n     5. Pull environment variables: `vercel env pull .env.development.local`\n\n5. Run the development server:\n\n```bash\nnpm run dev\n```\n\n## 🌐 Deployment\n\n1. Deploy to Vercel:\n\n```bash\nvercel deploy\n```\n\n2. Configure production environment variables in Vercel Dashboard:\n   - Add all variables from `.env.example`\n   - Connect Vercel KV storage\n\n## 💡 Usage\n\n1. Visit the homepage\n2. Search for any Wikipedia topic\n3. Select from the autocomplete suggestions\n4. Click \"Generate Timeline\" to view your interactive timeline\n5. For multiple timelines, keep adding topics before generating\n\n## 🎯 Example Timelines\n\n- ![George Washington \u0026 Qianlong Emperor](public/featured/George_Washington_and_Qianlong_Emperor.png)\n  [George Washington \u0026 Qianlong Emperor](https://wiki-timeline.com/timeline/George_Washington%7CQianlong_Emperor) - Two great leaders, two empires, one era\n\n- ![The Three Titans](public/featured/Michelangelo_Leonardo_da_Vinci_Raphael.png)\n  [The Three Titans](https://wiki-timeline.com/timeline/Michelangelo%7CLeonardo_da_Vinci%7CRaphael) - Renaissance masters who shaped art history\n\n- ![The Poet Saints](public/featured/Li_Bai_and_Du_Fu.png)\n  [The Poet Saints](https://wiki-timeline.com/timeline/Li_Bai%7CDu_Fu) - China's greatest poets of the Golden Age\n\n## 🛠️ Tech Stack\n\n- **Framework**: Next.js 14 with App Router\n- **Styling**: Tailwind CSS\n- **Database**: Vercel KV (Redis)\n- **AI**: [Cursor/Claude for development](https://www.cursor.com/), [Gemini for timeline generation](https://makersuite.google.com/app/apikey)\n- **Deployment**: Vercel\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  Built by \u003ca href=\"https://x.com/organic_program\"\u003eWenzheng Li (aka Steven Lee)\u003c/a\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwenzhenl%2Fwikitimeline","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwenzhenl%2Fwikitimeline","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwenzhenl%2Fwikitimeline/lists"}