https://github.com/murabcd/compass
Realtime Voice AI Recruiter Built With Tanstack Start, Convex and OpenAI
https://github.com/murabcd/compass
convex openai react tanstack-router tanstack-start vite
Last synced: about 2 months ago
JSON representation
Realtime Voice AI Recruiter Built With Tanstack Start, Convex and OpenAI
- Host: GitHub
- URL: https://github.com/murabcd/compass
- Owner: murabcd
- Created: 2025-07-01T11:00:18.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-18T21:55:56.000Z (10 months ago)
- Last Synced: 2025-07-19T02:07:26.572Z (10 months ago)
- Topics: convex, openai, react, tanstack-router, tanstack-start, vite
- Language: TypeScript
- Homepage: https://compass-hr.vercel.app
- Size: 1.22 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Realtime Voice AI Recruiter Built With Tanstack Start, Convex and OpenAI.
This project uses the [OpenAI Agents SDK](https://github.com/openai/openai-agents-js), a toolkit for building, managing, and deploying advanced AI agents.
- Comprehensive candidate and jobs management with AI-powered workflows
- Multi-stage real-time AI voice interview system with seamless agent handoffs
- Public interview sharing with candidate onboarding flow and progress tracking
- AI-powered talent sourcing and matching with verified profiles
- Smart job creation with optimized descriptions and automated hiring pipelines
- Real-time transcript analysis and interview performance insights
> **NOTE:** ❗ This project is in very early development and lots of things will change.
Features ·
Model Provider ·
Deploy Your Own ·
Running locally
## Features
- [Tanstack Start](https://tanstack.com/start/latest)
- File-based routing, type-safe from server to client
- Built on Vite for a lightning-fast HMR development experience
- [OpenAI](https://openai.com/)
- Leverages OpenAI's powerful models for generation.
- Direct API calls for text generation and other AI features.
- [Shadcn/UI](https://ui.shadcn.com)
- Styling with [Tailwind CSS](https://tailwindcss.com)
- Component primitives from [Radix UI](https://radix-ui.com) for accessibility and flexibility
- [Convex](https://www.convex.dev/)
- Real-time database for storing user profiles, job listings, and application data
- Optimized file storage with automatic caching and CDN distribution
- [Convex Auth](https://labs.convex.dev/auth)
- Simple and secure authentication without external services
- Built-in support for magic links, OTPs, OAuth, and password authentication
## Model Provider
This app utilizes the [OpenAI API](https://openai.com/) for its AI capabilities. You will need to provide your own OpenAI API key in the environment variables.
## Deploy Your Own
You can deploy your own version of the OpenChat to Vercel with one click:
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fmurabcd%2Fcompass&env=CONVEX_DEPLOY_KEY,VITE_OPENAI_API_KEY&envDescription=Learn%20more%20about%20how%20to%20get%20the%20API%20Keys%20for%20the%20application&envLink=https%3A%2F%2Fgithub.com%2Fmurabcd%2Fcompass%2Fblob%2Fmain%2F.env.example&demo-title=Compass&demo-description=Realtime%20Voice%20AI%20Recruiter%20built%20with%20Tanstack%20Start%2C%20Convex%2C%20and%20OpenAI.&demo-url=https%3A%2F%2Fcompass-hr.vercel.app)
## Running locally
You will need to use environment variables to run Compass. It's recommended you use [Vercel Environment Variables](https://vercel.com/docs/projects/environment-variables) for this, but a local `.env` file is also sufficient.
> Note: You should not commit your `.env` file as it may expose secrets that could compromise your accounts.
1. Install dependencies:
```bash
bun install
```
2. If using Vercel for environment variables:
a. Install Vercel CLI: `bun i -g vercel`
b. Link local instance: `vercel link`
c. Download environment variables: `vercel env pull`
3. Start the development server:
```bash
bun dev
```
Your app should now be running on [localhost:3000](http://localhost:3000/).
