Documentation — v1.0

Your intelligent
career partner.

Renqore is an AI-powered job search platform. It combines a conversational language model with real-time job data to help you discover roles that actually match your background — not just keyword hits.

01 — Overview

What is Renqore?

Renqore is not a traditional job board. It acts as a career assistant you can talk to — describe what you're looking for in plain language, and it handles the search, filtering, and matching. Results are surfaced inside a chat conversation so context is never lost.

The platform is built around three ideas: a smart conversational interface, persistent conversation history with job results attached, and a personal profile (CV + preferences) that makes every search more relevant over time.

Conversational Search

Ask for jobs in natural language. The AI interprets your intent and executes targeted searches.

CV-Aware Matching

Upload your CV and Renqore uses its contents to refine search queries and results to fit your profile.

Persistent History

Every conversation and its job results are saved. Resume any session exactly where you left off.

Star & Track Jobs

Bookmark interesting roles with a single click. Access all starred jobs across every conversation from one place.

02 — How It Works

From prompt to apply link

A single message flows through several layers before results appear in your chat.

  1. 01

    You type a prompt

    Describe what you're looking for — a job title, industry, location, seniority, or a mix of all of these. Natural language works best.

  2. 02

    Quota & traffic check

    The system verifies your daily request quota and checks overall server load before proceeding, ensuring fair access for all users.

  3. 03

    AI processes context

    The language model reads your full conversation history alongside your settings (custom instructions, career description, CV text) to build a rich understanding of the request.

  4. 04

    Job search executes

    The AI triggers a job search tool, which queries live job listings. Results are indexed and attached to your conversation document in the database.

  5. 05

    Response rendered

    The model's reply and the job cards appear in your chat. Each job card shows title, company, location, salary, and a direct apply link. Job groups are labelled by the search query that produced them.

03 — Getting Started

Your first session

Renqore uses Google OAuth for sign-in — no separate password required to get going. Once authenticated, you land on the main chat interface.

Tip — set your profile first Head to Settings before your first search. A career description and/or uploaded CV substantially improves the relevance of every result.
  1. 01

    Sign in with Google

    Tap "Continue with Google" on the sign-in page. A new account is created automatically on your first login.

  2. 02

    Visit Settings

    Optionally upload a PDF CV, write a short career description, and add any custom instructions for how the AI should respond to you.

  3. 03

    Start a conversation

    A new conversation is created automatically when you first land on the chat page. Type your first message to begin — or tap one of the example prompts.

  4. 04

    Browse results & star roles

    Job results appear as cards via the Jobs panel. Star any role to save it for later — starred jobs are accessible from any conversation.

04 — Features

AI Chat & Job Search

The chat interface is the core of Renqore. Every message you send is processed by a language model that has full access to your conversation history and personal settings. This means follow-up questions, refinements, and clarifications all work naturally.

When the model determines a job search is needed, it fires a tool call behind the scenes — you never have to trigger a search manually. The results are grouped by the search query that produced them, so if you ask for several different kinds of roles in one session, results stay clearly organised.

Conversation token limit Very long conversations will eventually reach a context limit. When this happens, the conversation is marked as closed and you're prompted to start a new one. Your history and starred jobs are never lost.

Conversations

Each conversation is an independent session stored in your account. Conversations are titled automatically after your first few messages using a second AI call — so your history is always readable at a glance.

Action Description
New Conversation Creates a fresh session. If an empty conversation already exists, it is reused rather than creating a duplicate.
Resume Conversation Open any past conversation from the History modal. The full message thread and all attached job results are restored.
Delete Conversation Permanently removes the conversation and all job results associated with it from your account.
Auto-title Titles are generated from your first few prompts after the conversation accumulates enough content. Short first prompts (< 5 words) are used as the title directly.

Settings & CV

The Settings page lets you personalise how the AI understands and responds to you. Changes take effect on your next message.

Setting What it does Limit
Model Instructions Custom behavioural instructions for the AI — e.g. "always include salary info" or "be concise". 45 words
Career Description A short paragraph about your current role, goals, and preferred employment type. Used to bias job searches toward your profile. 45 words
CV Upload Upload a PDF CV. Text is extracted and stored so the AI can reference your skills and experience without you repeating them. PDF only
Privacy note Your CV text and career description are stored against your account only. They are never visible to other users and are deleted in full when you delete your account.

Starred Jobs

Star any job card in the Jobs panel to save it. Starred jobs are stored within their conversation but surfaced together in the "All Starred Jobs" view — accessible from any conversation via the Jobs panel header.

Each starred job retains its original data: title, company, location, salary, description, and direct apply link. Unstarring is equally simple and takes effect immediately.

05 — System

API Endpoints

All endpoints require an active session (authenticated via Google OAuth or email/password). Unauthenticated requests return 401.

Chat

POST/api/chat

Conversations

GET/api/conversations
GET/api/conversation/:id
POST/api/conversation/create
DEL/api/conversation/:id
POST/api/conversation/generate-title

Jobs

GET/api/conversation/has-jobs
GET/api/conversation/jobs-grouped
GET/api/conversation/all-starred
POST/api/conversation/star-job
POST/api/conversation/unstar-job
GET/api/job/apply-link

Settings

GET/api/settings/get
POST/api/settings/save
POST/api/settings/save_career
POST/api/settings/upload_cv
GET/api/settings/get_cv
POST/api/settings/delete_cv

Account

POST/user/logout-and-delete

Quota & Limits

Renqore operates a two-tier quota system to ensure fair access. Quotas reset daily via an automated process.

Limit Scope Behaviour when hit
Universal quota All users combined Returns 503 traffic_limit_reached. No requests are processed until quota resets.
Per-user quota Individual account Returns 400 quota_reached. Your quota resets the following day.
Conversation context Single conversation Returns 400 token_limit_exceeded. Start a new conversation to continue.
Upstream rate limits Occasional 503 responses may occur due to rate limits from the underlying AI provider. These are temporary — wait a few moments and try again.

Data & Privacy

All user data is stored in a private MongoDB database. Connections use TLS in transit. No user data is shared with third parties. The following data is held per account:

Collection What is stored
users Name, email, hashed password (bcrypt), join date, activity flags.
conversations Message threads, model responses, job results, timestamps.
settings Model instructions, career description, extracted CV text, GridFS file reference.
fs.files / fs.chunks Original PDF CV file stored via MongoDB GridFS.

Account Management

All account operations are accessible from the Settings page. Renqore supports both Google OAuth accounts and email/password accounts. Google users can set a Renqore password at any time from the main chat interface.

Account deletion is permanent Deleting your account removes all data across every collection — conversations, job results, settings, and uploaded CV files. This cannot be undone. A confirmation dialog is shown before any deletion proceeds.
  1. 01

    Navigate to Settings

    Use the sidebar or the back-arrow button to reach your Settings page from the chat interface.

  2. 02

    Click "Delete account"

    A confirmation modal will appear warning you that the action is permanent.

  3. 03

    Confirm

    All data is deleted server-side, your session is cleared, and you are redirected to the home page.