A multi-perspective historical narrative platform that presents historical events through the lens of different countries, communities, religions, ideologies, and academic viewpoints — all side by side.
View Demo · Report Bug · Request Feature
|
Get 5+ unique perspectives on any historical event — from different countries, communities, religions, and academic schools of thought. Beautiful light and dark modes with system preference detection for comfortable viewing. Powered by Groq's ultra-fast inference delivering responses at ~500 tokens/second. |
Clean, ChatGPT-inspired interface with horizontal card carousel for easy comparison. Seamless experience across desktop, tablet, and mobile devices. Every perspective includes academic sources and bias acknowledgments for transparency. |
| Light Theme | Dark Theme |
- Node.js 18+
- npm or yarn
- Groq API Key (Get one free)
# Clone the repository
git clone https://github.com/harshwardhan-kp/PolyLens.git
# Navigate to project directory
cd PolyLens
# Install dependencies
npm install
# Create environment file
echo "GROQ_API_KEY=your_groq_api_key_here" > .env.local
# Start development server
npm run devOpen http://localhost:3000 in your browser 🎉
PolyLens/
├── 📂 app/
│ ├── 📂 api/
│ │ └── 📂 chat/
│ │ └── 📄 route.ts # Groq API endpoint
│ ├── 📄 page.tsx # Main chat interface
│ ├── 📄 page.module.css # Component styles
│ ├── 📄 layout.tsx # Root layout
│ └── 📄 globals.css # Design system
├── 📂 lib/
│ └── 📄 prompts.ts # AI prompts & types
├── 📄 .env.local # Environment variables
├── 📄 package.json
└── 📄 README.md
| Feature | Description | Status |
|---|---|---|
| 💾 Save Conversations | Persist chat history to database | 🔜 Planned |
| 👤 User Accounts | Authentication with Google/GitHub | 🔜 Planned |
| 📊 Analytics Dashboard | Track popular queries and perspectives | 🔜 Planned |
| 🌍 Multi-language | Support for 10+ languages | 🔜 Planned |
| 📱 Mobile App | Native iOS/Android with React Native | 🔜 Planned |
| 🎯 Custom Perspectives | User-defined viewpoint categories | 🔜 Planned |
| 📚 Source Links | Direct links to academic papers | 🔜 Planned |
| 🤖 Multiple LLMs | Switch between GPT-4, Claude, Gemini | 🔜 Planned |
Contributions are what make the open source community amazing! Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Harshwardhan KP
