A modern, AI-powered career guidance platform that provides personalized career recommendations, detailed education pathways, and comprehensive skill development plans.
- 🎯 Personalized Career Advice: Get tailored recommendations based on your interests and goals
- 📚 Detailed Education Pathways: Comprehensive degree information including duration, costs, and requirements
- 🛠️ Skill Development Plans: Step-by-step learning paths with specific timelines
- 💬 Interactive Chat Interface: Engaging conversation-based career exploration
- 📱 Responsive Design: Beautiful, modern UI that works on all devices
- 🔄 Session Management: Save and continue your career exploration sessions
- React 18 with TypeScript
- Vite for fast development and building
- Tailwind CSS for styling
- shadcn/ui for beautiful UI components
- Node.js with Express
- TypeScript for type safety
- OpenAI API integration for AI-powered advice
- SQLite with Drizzle ORM for data persistence
- Node.js (v18 or higher)
- npm or yarn package manager
-
Clone the repository
git clone https://github.com/yourusername/career-advice-app.git cd career-advice-app -
Install dependencies
npm install
-
Set up environment variables Create a
.envfile in the root directory:OPENAI_API_KEY=your_openai_api_key_here PORT=5000
-
Start the development server
npm run dev
-
Open your browser Navigate to
http://localhost:5000
- Start a conversation by typing your career interests or questions
- Ask about specific careers like "I want to become a software engineer"
- Get detailed information about:
- Career overview and opportunities
- Recommended degrees and education paths
- Essential skills needed
- Step-by-step learning roadmap
- "What should I study to become a data scientist?"
- "I'm interested in teaching, what are my options?"
- "How do I transition into software engineering?"
- "What skills do I need for a career in marketing?"
- Detailed Degree Information: Specific degree names, duration, and estimated costs
- Multiple Pathways: Traditional university, community college, bootcamps, and certifications
- Contextual Skills: Skills explained with real-world applications
- Actionable Learning Plans: Time-bound steps with clear milestones
When the AI service is unavailable, the app provides comprehensive fallback advice covering:
- Software Engineering
- Data Science
- Teaching
- General career guidance
npm run dev- Start development servernpm run build- Build for productionnpm run start- Start production servernpm run lint- Run linting
├── client/ # Frontend React application
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ ├── pages/ # Page components
│ │ ├── hooks/ # Custom React hooks
│ │ └── types/ # TypeScript type definitions
├── server/ # Backend Express application
│ ├── services/ # Business logic and external APIs
│ ├── routes.ts # API route definitions
│ └── storage.ts # Database operations
├── shared/ # Shared types and schemas
└── README.md
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
If you have any questions or need help, please:
- Open an issue on GitHub
- Check the documentation
- Contact the maintainers
- OpenAI for providing the AI capabilities
- The React and Node.js communities
- All contributors who help improve this project
Made with ❤️ for career seekers everywhere