FoloUp - AI-powered voice interviewer for hiring 💼

FoloUp is an open source platform for companies to conduct AI powered hiring interviews with their candidates.

<img src="https://github.com/user-attachments/assets/91adf737-6f62-4f48-ae68-58855bc38ccf" alt="Description 1" width="400" style="max-width: 100%;">






<img src="https://github.com/user-attachments/assets/91bbe5d5-1eff-4158-80d9-d98c2a53f59b" alt="Description 2" width="400" style="max-width: 100%;">

Key Features

• 🎯 Interview Creation: Instantly generate tailored interview questions from any job description.
• 🔗 One-Click Sharing: Generate and share unique interview links with candidates in seconds.
• 🎙️ AI Voice Interviews: Let our AI conduct natural, conversational interviews that adapt to candidate responses.
• 📊 Smart Analysis: Get detailed insights and scores for each interview response, powered by advanced AI.
• 📈 Comprehensive Dashboard: Track all candidate performances and overall stats.

Here's a loom of me explaining the app.

Initial Setup

1. Clone the project.

git clone https://github.com/FoloUp/FoloUp.git

1. Copy the existing environment template file

cp .env.example .env

Clerk Setup (Clerk)

We use Clerk for authentication. Set up Clerk environment variables in the .env file. Free plan should be more than enough.

1. Navigate to Clerk and create an application following the setup guide.

1. Your .env (NOT .env.local) file should have the NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY and CLERK_SECRET_KEY variables populated with no inverted commas

2. Enable organizations in your Clerk application by navigating to the Organization Settings page.

1. Make sure you create an organization and invite your email to it.

Database Setup (Supabase)

Supabase is used for storing the data. It's really simple to set up and the free plan should suffice.

1. Create a project (Note down your project's password)
2. Got to SQL Editor and copy the SQL code from supabase_schema.sql

1. Run the SQL code to confirm the tables are created.
2. Copy the supabase url and anon key from the project settings and paste it in the .env file in NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY

Retell AI Setup (Retell AI)

We use Retell AI to manage all the voice calls. They manage storage of recordings and provide a simple SDK to integrate with. They provide free credits to start with and will have to pay as you go.

1. Create an API key from Retell AI Dashboard and add it to the .env file in RETELL_API_KEY

Add OpenAI API Key

We use OpenAI to generate questions for interviews and analyze responses. This would not be that costly.

1. Go to OpenAI and create an API key
2. Add the API key to the .env file in OPENAI_API_KEY

Getting Started locally

First install the packages:

yarn

Run the development server:

yarn dev

Open http://localhost:3000 with your browser to see the result.

Self Hosting

We recommend using Vercel to host the app.

Contributing

If you'd like to contribute to FoloUp, feel free to fork the repository, make your changes, and submit a pull request. Contributions are welcomed and appreciated.

For a detailed guide on contributing, read the CONTRIBUTING.md file.

Show Your Support 🌟

If you find FoloUp helpful, please consider giving us a star on GitHub! It helps us reach more developers and continue improving the project.

Products built on top of FoloUp 🚀

Contact

If you have any questions or feedback, please feel free to reach out to us at suveen.te1[at]gmail.com.

License

The software code is licensed under the MIT License.