https://github.com/ayush585/edgex
Edgex is a Gen Z-powered AI mentorship movement — not just code. We help students navigate emotional chaos and career confusion with smart, empathetic AI. Built with passion, heart, and vision. 💬🎯 Join the mission. Be the reason someone finds clarity.
https://github.com/ayush585/edgex
ai ai-chatbot ai-mentor career-guidance career-mentor edgex emotional-support firebase-auth genz groq gssoc gssoc25 llama3 machine-learning mentorship nodejs open-source react student-wellbeing
Last synced: 3 months ago
JSON representation
Edgex is a Gen Z-powered AI mentorship movement — not just code. We help students navigate emotional chaos and career confusion with smart, empathetic AI. Built with passion, heart, and vision. 💬🎯 Join the mission. Be the reason someone finds clarity.
- Host: GitHub
- URL: https://github.com/ayush585/edgex
- Owner: ayush585
- License: mit
- Created: 2025-07-17T07:04:52.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-10-31T07:49:13.000Z (8 months ago)
- Last Synced: 2025-10-31T09:29:39.647Z (8 months ago)
- Topics: ai, ai-chatbot, ai-mentor, career-guidance, career-mentor, edgex, emotional-support, firebase-auth, genz, groq, gssoc, gssoc25, llama3, machine-learning, mentorship, nodejs, open-source, react, student-wellbeing
- Language: JavaScript
- Homepage: https://edgex-brown.vercel.app/
- Size: 225 MB
- Stars: 13
- Watchers: 0
- Forks: 36
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 🧠 Edgex – Gen Z Mentorship Suite (GSSoC 2025 🌟)
  
**Edgex** is an open-source AI-powered mentorship platform built for **Gen Z** – helping students make **smarter emotional and career decisions** with the guidance of intelligent, empathetic, and memory-aware AI agents.
> 🚀 Project Admin: [@ayush585](https://github.com/ayush585) | 💥 Open Source under GSSoC 2025
> Would recommend to join this discord server for 2x productivity! [Discord-server](https://discord.gg/rnfEbBPBgE)
---
## 📢 This Project Has Two Parts:
- 🔗 **Frontend Repository**: [ayush585/edgex](https://github.com/ayush585/edgex) ← *(this repo)*
- 🔗 **Backend Repository**: [ayush585/edgex-backend](https://github.com/ayush585/edgex-backend)
Both are actively maintained and open for contributions.
---
## 📦 Live Projects in Edgex
### Landing page -
🔗 [Live Demo](https://edgex-brown.vercel.app/)
### 🫀 MoodMirror — AI for Emotional Clarity
> Analyze chats & relationships. Detect friendzone, rizz, manipulation, or overthinking – with real advice.
🔗 [Live Demo](https://edgex-brown.vercel.app/moodmirror) | 🤖 Powered by Groq LLMs
### 🎓 CareerCrack — Memory-Powered Career Mentor
> Personal guidance based on user’s name, dreams, and passions. Helps teens discover their true calling.
🔗 [Live Demo](https://edgex-brown.vercel.app/careercrack)
### 🎓 Scholarship Scout -
> Personal guidance based on details of the student for scholarship!
🔗 [Live Demo](https://edgex-brown.vercel.app/scholarships)
### 🎓 Smart Notes -
> coming soon
🔗 [Live Demo](https://edgex-brown.vercel.app/smartnotes)
### Voice feedback -
> coming soon!
🔗 [Live Demo](https://edgex-brown.vercel.app/voicefeedback)
---
## 💡 What Problem Does Edgex Solve?
- 🤯 No real mentors for most students
- 💔 Emotional confusion in relationships
- 🎯 Overwhelming career paths with no personalized direction
- 🎯 Scholarship hunt via AI
Edgex offers:
- 👩🏫 AI mentors with memory
- 📄 Save & export chats as PDFs
- 🌗 Beautiful UI with dark mode
- 🔒 Firebase Auth for secure user sessions
---
## 🛠️ Tech Stack
| Frontend | Backend | Database | AI/LLM | Backend
|-----------------|------------------|----------------------|--------------------------------|-------------
| React + Tailwind | Express (Node.js) | Firebase Firestore + Auth | Groq LLM API (LLaMA 3) | Node.js
Also uses:
- 🔁 Axios for API calls
- 🧾 jsPDF for PDF export
- 🎨 Lucide-react icons
- 🌐 Deployed on Netlify & Render
---
## 🚀 Local Setup
### 1. Clone the repo:
git clone https://github.com/ayush585/edgex.git
cd edgex
Install dependencies:
npm install
Set up environment variables:
For Backend (groq-proxy.js or backend folder):
GROQ_API_KEY=your_groq_key_here
Start development servers:
Frontend:
npm run dev
Backend:
......
🤝 Contributing to Edgex (GSSoC 2025)
We welcome developers, students, and AI enthusiasts!
🗺️ Good First Issues – More exciting ones coming soon:
✅ UI enhancements
🧠 AI prompt tuning
🐛 Bug fixing
💡 Feature ideas
🛠️ Vercel deployment troubleshooting (currently under deployment!)
📄 Contribution Guidelines
🍴 Fork & clone the repo
🔀 Create a new branch: feature/my-feature
⬆️ Push and open a PR with a clear title & meaningful description
💬 Comment your logic clearly
🤝 Be kind & helpful to fellow contributors
## Contributors:-
Ayushman Mukherjee Project Admin @ayush585 [github](https://github.com/ayush585) 
Aishika 💫 Contributor @aishikabiswas [github](https://github.com/aishikabiswas)
Kris 💫 Contributor [github](https://github.com/kris2005mehra)
You? Contributor ⭐ Star the repo & contribute!
Want your name here? Submit a valid PR and we’ll add you 💖
🧑💻 Mentorship Tools Built for Gen Z
Edgex isn’t just a project — it’s a movement to give every student:
💬 Emotional clarity
🎯 Career confidence
💡 Smart, memory-based AI guidance
🛡️ License
This project is licensed under the MIT License.
💬 Want to Collaborate?
📧 Email: ayushmanmukherjee12@gmail.com
🔗 LinkedIn: Ayushman Mukherjee [Linkedin](https://www.linkedin.com/in/ayushman-mukherjee-437a49314/)
💬 Discord: Sabucha | PA
⭐ Give Edgex a Star!
If you love what we're building, star the repo and share it with your dev friends!
Let’s make AI mentorship the new normal for Gen Z 💥
[⬆️ Back to Top](#readme)