Hustlers is a full-stack platform that helps job seekers and freelancers discover opportunities, evaluate companies, and generate AI-powered insights and outreach. It includes a FastAPI backend for data aggregation, AI services, and integrations, plus a Flutter mobile app with a clean-architecture UI for discovery, analysis, and resume tooling.
- Aggregates jobs from Telegram channels and groups.
- Helps evaluate companies using map-based discovery and AI-generated insights.
- Parses resumes and provides role-specific improvement suggestions.
- Scores GitHub portfolios against target roles.
- Deep company analysis to surface pain points.
- AI-generated outreach pitch with CTA to close leads faster.
Hustlers is split into two major parts:
- Backend: FastAPI services for Telegram scraping, AI analysis, resume parsing, GitHub scoring, maps, and persistence.
- Mobile App: Flutter app using Clean Architecture, Riverpod, and rich UI for search, insights, and resume tooling.
For component-specific documentation:
- Backend details are in backEnd/README.md
- Mobile details are in hustlers_mobile/README.md
┌───────────────────────┐ ┌────────────────────────────┐
│ Flutter Mobile App │──────▶│ FastAPI Backend (REST) │
│ - Job Finder │ │ - Telegram Services │
│ - Company Insights │ │ - AI/Gemini Insights │
│ - Resume Tools │ │ - Resume Parsing │
│ - Saved Items │ │ - GitHub Scoring │
└───────────────────────┘ └────────────────────────────┘
▲ │
│ ▼
Local Cache PostgreSQL / APIs
- Telegram group/channel aggregation with configurable group sources.
- Job post normalization and structured extraction.
- Nearby company search via map services.
- Gemini-powered insights on digital presence, pain points, and opportunities.
- PDF extraction for skills, experience, education, and contact.
- AI suggestions based on GitHub portfolio + target role.
- Public repo analysis for role fit.
- Evidence-based scoring and highlights.
- Feature-first clean architecture.
- Smooth UI with charts and deep analytics.
- Saved companies and curated insights.
Hustlers/
├── backEnd/ # FastAPI backend services
│ ├── app/ # API, services, models, db
│ └── README.md
├── hustlers_mobile/ # Flutter mobile client
│ ├── lib/
│ └── README.md
└── README.md # This file
- FastAPI
- PostgreSQL + SQLAlchemy
- Google Gemini (LLM)
- Telethon
- pdfplumber
- Railway deployment
- Flutter + Dart
- Riverpod (Hooks + Codegen)
- sqflite + shared_preferences
- http client
- fl_chart + percent_indicator
git clone https://github.com/your-username/Hustlers.git
cd Hustlers
Follow backEnd/README.md for Python environment, DB, and secrets.
Follow hustlers_mobile/README.md for Flutter dependencies and run steps.
Create a .env file in backEnd or configure environment variables in deployment.
DATABASE_URL=postgresql://user:pass@localhost/hustlers_db
TELEGRAM_API_ID=your_id
TELEGRAM_API_HASH=your_hash
TELEGRAM_SESSION=your_base64_session_string
GEMINI_API_KEY=your_gemini_key
GITHUB_TOKEN=your_github_token
cd backEnd
pytest
cd hustlers_mobile
flutter test
- Backend: Railway or similar PaaS with Postgres
- Mobile: Flutter build for Android, iOS, Web, and Desktop
See backEnd/README.md for deployment specifics.
- Centralized admin dashboard for analytics
- Company lead scoring system
- Multilingual content generation
- Push notifications for new matches
- Saved outreach templates
Contributions are welcome. Please open a PR with clear context and tests where applicable.
MIT — see LICENSE file if present.
Built with ❤️ by the Hustlers team.