🏔️ Far Reach Jobs

An ethical job aggregator for remote Alaskan communities, bush villages, and tribal organizations.
Find opportunities in places most job boards don't reach.

🌐 Live Site • 🚀 Quick Start • 🤝 Contributing • 🗺️ Roadmap

---

🎯 Why This Exists

Job seekers interested in remote Alaska face a fragmented landscape - positions are scattered across dozens of small employer websites, tribal organization portals, and government HR systems.

Far Reach Jobs brings them together in one searchable place.

We aggregate listings from bush villages, tribal organizations, rural hospitals, and small-town governments - then link you directly back to the original source to apply.

---

✨ Features

Feature	Description
🔍 Smart Search	Filter by keyword, city/community, and job type
💾 Save Jobs	Track positions you're interested in
🌙 Dark Mode	Easy on the eyes, day or night
📱 Mobile-First	Responsive design that works everywhere
🤖 AI-Powered Setup	Auto-detect CSS selectors for new job sources
⏰ Daily Updates	Fresh jobs scraped at noon Alaska time

---

🛠️ Tech Stack

┌─────────────────────────────────────────────────────────┐
│                      Frontend                           │
│          HTMX • Jinja2 Templates • Tailwind CSS        │
├─────────────────────────────────────────────────────────┤
│                      Backend                            │
│              FastAPI • SQLAlchemy • MySQL               │
├─────────────────────────────────────────────────────────┤
│                     Scraping                            │
│    Playwright • BeautifulSoup • Anthropic Claude API   │
├─────────────────────────────────────────────────────────┤
│                    Deployment                           │
│           Docker Compose • Nginx Proxy Manager          │
└─────────────────────────────────────────────────────────┘

---

🚀 Quick Start

# Clone the repo
git clone https://github.com/mbuckingham74/Far-Reach-Jobs.git
cd Far-Reach-Jobs

# Copy environment config
cp .env.example .env

# Create Docker network (first time only)
docker network create npm_default

# Start services
docker compose up -d --build

Then visit http://localhost:8000 🎉

📖 See CONTRIBUTING.md for detailed setup instructions.

---

🤝 Contributing

We welcome contributions from developers of all skill levels!

📋	Contributing Guide Setup and development guidelines
🗺️	Roadmap Planned features and improvements
🐛	Issues Open tasks and bug reports

👋 Good First Issues

• 📍 Suggest new Alaska job sources via the "New Job Source" issue template
• ✅ Improve test coverage
• 🎨 UI/UX enhancements

---

👔 For Employers

Are you an employer in remote Alaska? We'd love to include your jobs!

Visit our For Employers page to:

• 📝 Submit a single job - Fill out a simple form
• 🔗 Add your careers page - We'll set up automatic scraping
• 📊 Bulk import - Upload a CSV with multiple organizations

🚫 Want to be excluded from scraping? Open an issue and we'll remove your site.

---

⚙️ Admin Features

Far Reach Jobs includes a powerful admin panel for managing job sources:

🤖 AI-Powered Scraper Configuration (Anthropic Claude)

We use the Anthropic Claude API to intelligently analyze job listing pages and automatically configure scrapers:

• Analyze Page with AI - Claude examines the HTML structure and suggests optimal CSS selectors for extracting job titles, URLs, locations, and more
• Generate Custom Scraper - For complex sites that don't fit standard patterns, Claude generates complete Python scraper code tailored to the specific page structure
• Smart Detection - Handles JavaScript-rendered pages, pagination, and various HTML layouts automatically

This approach dramatically reduces the manual effort of adding new job sources - what used to take hours of CSS selector trial-and-error now takes seconds.

📋 Adding a New Source

1. Go to Admin Dashboard → Add Scrape Source
2. Enter the source name and base URL
3. Click "Analyze Page with AI" to auto-detect selectors
4. Review suggestions and click "Apply All"
5. Set a default location (e.g., "Bethel")
6. Save and test with a manual scrape

📊 Bulk Import via CSV

Source Name,Base URL,Jobs URL
City of Bethel,https://www.cityofbethel.net,https://www.cityofbethel.net/jobs
NANA Regional,https://nana.com,https://nana.com/careers

Upload via Admin Dashboard → Bulk Import from CSV. Duplicates are automatically skipped.

---

🙏 Ethics & Respect

• ✅ We respect robots.txt rules
• ✅ We identify ourselves as FarReachJobs/1.0 in our User-Agent
• ✅ We honor crawl delays when specified
• ✅ We link directly to original listings (no job duplication)

---

📄 License

MIT © Far Reach Jobs

---

Built with ❤️ for Alaska's remote communities
_{Connecting job seekers with opportunities in places most job boards don't reach}