A web app to explore, discover and compare Tanzanian universities, offering personalized recommendations and data insights. Built by Zuck30 from Tanzania.

Quick Links

• 🔭 Discover More than 30 Tanzanian universities.
• 👨‍💻 Built with React, FastAPI, and ECharts for seamless exploration.
• 🌍 Personalized recommendations and interactive insights for students.

Skills & Technologies

Frontend

Backend

Tools

Project Overview

Sekela is a web app designed to help Tanzanian students explore and compare higher education institutions. With data on more than 30 universities, it offers advanced search, personalized recommendations via a Smart Wizard, and interactive visualizations of university stats, empowering students to make informed choices.

• University Explorer: Browse, filter, and compare universities by region, type, fees, and difficulty.
• Smart Wizard: Get tailored university recommendations based on preferences.
• Data Insights: Visualize university distribution and admission stats with ECharts.
• Detailed Profiles: Access comprehensive info on programs, facilities, and fees.
• Tanzanian Focus: Sourced from TCU, NACTE, and official university data.

Quick Start

Prerequisites

• Node.js 18+ and npm
• Python 3.8+ and pip
• Git

Installation

1. Clone the repository:

   git clone https://github.com/zuck30/sekelafinder.git
   cd sekelafinder

2. Backend Setup:

   cd backend
   python -m venv venv
   source venv/bin/activate  # Windows: venv\Scripts\activate
   pip install -r requirements.txt
   uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

3. Frontend Setup:

   cd frontend
   npm install
   npm run dev

4. Initialize Data:

   curl -X POST http://127.0.0.1:8000/scrape/refresh

5. Access the App:

   • Frontend: http://localhost:5173
   • API Docs: http://127.0.0.1:8000/docs

Key Features

• Homepage: Hero section with quick stats and featured universities.
• University Explorer: Search and compare 30+ universities with filters for region, type, and fees.
• Smart Wizard: Personalized recommendations via an intelligent matching algorithm.
• Data Insights: Interactive charts for regional analysis and admission difficulty.
• University Profiles: Detailed info on programs, facilities, and financials.

API Endpoints

• Base URL: http://127.0.0.1:8000
• Key Endpoints:
  • GET /universities/: List all universities.
  • GET /universities/{id}: Get university by ID.
  • GET /insights/regions: Universities by region.
  • POST /wizard/recommendations: Personalized recommendations.
  • POST /scrape/refresh: Refresh university data.
• Docs: Swagger UI, ReDoc

University Data

• 30+ Universities: 12 public (TCU-regulated), 18 private (NACTE and others).
• Regions Covered: 9 regions across Tanzania.
• Data Sources: TCU, NACTE, and university websites.
• Includes: Names, locations, programs, fees, facilities, and admission requirements.

☕️ Support the Project

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Tanzania Commission for Universities (TCU) for public university data.
• NACTE for private institution data.
• React and FastAPI communities for robust frameworks.

🆘 Support

For issues, check the API documentation or open a GitHub issue. Contact mwalyangashadrack@gmail.com for help.