{"id":28406644,"url":"https://github.com/akhilk2802/helix","last_synced_at":"2026-05-10T03:37:56.630Z","repository":{"id":295920445,"uuid":"988709089","full_name":"akhilk2802/helix","owner":"akhilk2802","description":"Agentic Recruiter","archived":false,"fork":false,"pushed_at":"2025-06-05T14:34:08.000Z","size":12864,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-08T20:37:17.333Z","etag":null,"topics":["agentic-ai","flask","llm","openai-api","react"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/akhilk2802.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-23T00:47:30.000Z","updated_at":"2025-06-05T14:34:09.000Z","dependencies_parsed_at":"2025-05-28T03:44:00.572Z","dependency_job_id":null,"html_url":"https://github.com/akhilk2802/helix","commit_stats":null,"previous_names":["akhilk2802/helix"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/akhilk2802/helix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akhilk2802%2Fhelix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akhilk2802%2Fhelix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akhilk2802%2Fhelix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akhilk2802%2Fhelix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akhilk2802","download_url":"https://codeload.github.com/akhilk2802/helix/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akhilk2802%2Fhelix/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262569753,"owners_count":23330275,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","flask","llm","openai-api","react"],"created_at":"2025-06-01T22:36:28.461Z","updated_at":"2026-05-10T03:37:56.622Z","avatar_url":"https://github.com/akhilk2802.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Helix - The Agentic Recruiter\n\nHelix is a real-time AI-powered recruiter assistant designed to streamline the outreach process for recruiters. With Helix, recruiters can chat naturally, generate and edit personalized multi-step outreach sequences, and manage sequences manually through a workspace UI. \n\nThis tool is built with a combination of **React**, **Flask**, **PostgreSQL**, **Socket.IO**, **OpenAI GPT-4**, and **ChromaDB** to provide real-time interaction, memory recall, and intelligent sequence creation.\n\n\n---\n\n## Features\n\n- **Conversational AI** – Recruiters can talk to Helix naturally to create or modify outreach messages.\n- **Sequence Editor** – AI-generated recruiting sequences are editable directly in the UI with autosave support.\n- **Tool Call Detection** – Detects recruiter intent and dynamically calls backend tools (`create_sequence`, `edit_sequence`, `delete_step`).\n- **Workspace View** – Visually structured sequence steps for LinkedIn and Email messaging.\n- **Memory Integration** – Uses ChromaDB to remember recruiter-specific messages and context for future use.\n- **Real-time Updates** – Powered by Socket.IO for low-latency interactions.\n\n---\n\n## Tech Stack\n\n| Layer         | Technology                      |\n|--------------|----------------------------------|\n| Frontend     | React, TypeScript, Bootstrap     |\n| Backend      | Python, Flask, Flask-SocketIO    |\n| Database     | PostgreSQL (relational DB)       |\n| Vector Store | ChromaDB                         |\n| Embeddings   | OpenAI Embedding API             |\n| LLM          | OpenAI GPT-4                     |\n| Messaging    | Socket.IO (real-time messaging)  |\n\n---\n\n\n## Setting up locally\n\n### 1. Unzip the project\n```bash\ncd helix\n```\n\n### 2. Backend Setup - Flask\n- Prerequisites \n  - Python 3.0 +\n  - PostgreSQL\n  - OpenAI API Key\n  - ChromaDB\n  \n- create and setup environment variables in ```.env``` file\n  - ### Example .env file \n  \n  ```bash\n  DATABASE_URL=\n  CHROMA_DB_PORT=\n  OPENAI_API_KEY=\n  CHROMA_DB_URL=\n  ```\n\n\n  ```bash\n  cd backend\n  python3 -n venv .env\n  source venv/bin/activate\n  ```\n\n  - Install dependencies\n    ```bash\n    pip install -r requirements.txt\n    ```\n  - Start ChromaDB (as HTTP Server)\n    ```bash\n    chroma run --host localhost --port 8000\n    ```\n  - Run the backend server\n    ```bash\n    flask run\n    ```\n\n### 3. Frontend Setup - React\n-   Prerequisites\n    -   node 18+\n    -   npm\n- Create and Setup ```.env``` file\n  \n  - Example ```.env``` file\n  \n    ```\n    REACT_APP_API_URL=\n    REACT_APP_PORT=\n    ```\n- Start the frontend \n  \n    ```bash\n    npm start\n    ```\n\n    **Usually starts React at https://localhost:3000, unless a specific port is specified.**\n\n## Example workflow \n\n1.\tLog in with your name and company (mocked for now).\n2.\tChat with Helix: “Create a sequence for a Backend Engineer in New York with 5 years experience.”\n3.\tWatch Helix respond with a recruiting sequence.\n4.\tClick into the workspace panel and:\n    - Manually edit steps with autosave.\n    - Delete any step using the 🗑 icon.\n    - Ask Helix to edit or append new steps via chat.\n\n\n## How the UI looks \n\n### Login and Signup page\n\n![login-signup page 1](./project-layout/login.png)\n![login-signup page 2](./project-layout/signup.png)\n\n### Home page (after login)\n\n![Home Page](./project-layout/home3-instructions.png)\n\n### Architecture of the MVP \n\n![Architecture](./project-layout/helix-architecture.png)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakhilk2802%2Fhelix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakhilk2802%2Fhelix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakhilk2802%2Fhelix/lists"}