AI Freelance Agent FAS

An MVP that auto-handles freelance leads. A Telegram bot takes a job description; the AI agent analyzes, scores and generates a reply — the user just approves or edits the result.

PythonTelegram BotAI Pipeline SQLiteSQLAlchemyWriter Agent Critic AgentScorerOllama

For reference only — sources are not distributed

How it works

1. The user types /newjob → pastes the job text

2. Normalizer cleans and structures the data

3. Scorer rates the fit (0–100)

4. Strategy picks the reply tactic

5. Writer Agent generates a personalized reply

6. Critic Agent checks and improves quality

7. The bot shows the result with buttons: approve / edit / skip

Key systems

Telegram Bot UI

A full Telegram interface with inline buttons, FSM states and formatted messages. Commands: /start, /newjob, /jobs, /profile, /mode.

Writer + Critic Pipeline

Two-stage generation: Writer drafts the reply, Critic scores it and suggests improvements. Iterative refinement to acceptable quality.

Scoring Engine

An engine that scores how well a job fits the user's profile. Considers skills, experience, rate and employment-type preferences.

SQLite + SQLAlchemy

Persistent storage of jobs, replies, profile and history. Full ORM models with a repository.

4 AI modes

template (no AI), openai, ollama (local), manual_chat (the bot prepares the prompt, you paste it into any AI chat).