Legalka KB

About this product

Legalka KB is a knowledge base and a free Telegram bot for anyone going through legalisation in Poland. The key difference from an ordinary chatbot is that it doesn't make things up. Every answer comes strictly from a verified knowledge base, and if the base has no answer, the bot honestly says «I don't know» instead of inventing account numbers, deadlines, and office addresses.

The base has two layers that are never mixed: «norm» — what the law requires, with a source link for every fact — and «practice» — real timelines and observations from applicants, always with a validity date. Each fact in an answer is labelled «norm» or «practice», comes with official links for self-verification, and the answer itself arrives in the language of your question. Coverage: residence and work permits, visas, banking, employment, real estate, taxes, ZUS, citizenship, family reunification, education, international protection — all for Poland.

You don't have to type your question — you can dictate it by voice, and the bot can read any answer aloud. Under each answer there are handy buttons: rate it 👍/👎, show a Polish address on a map, turn the answer into a personal checklist, or suggest an edit. The interface and answers are available in five languages — Russian, Ukrainian, Belarusian, Polish, and English — and the bot remembers several parallel conversations, so you can keep separate topics without mixing up the context.

Behind the scenes, the practice layer is filled semi-automatically: a separate pipeline processes diaspora chats, anonymises the data, and sorts facts by topic, while a curator reviews and approves every page through a local panel with an AI editing agent. Answer quality is measured against a set of control questions, not assumed. The whole stack can run on your own server, with cloud models swapped for local ones — which matters for sensitive relocation data.

Key features

• Strict source binding — every statement cites a law article or official source
• Two content layers: normative (legally verified) and practical (community experience)
• Abstention: the bot says "I don't know" instead of hallucinating
• UA / BE / EN / PL support — content in Russian, bot responds in any language
• Telegram bot deployed on VPS via GitHub Actions
• Local review panel — curator sees diff, AI agent chat for editing, approve button
• Practice collection pipeline from Telegram chats with PII filter and automatic staging
• Eval suite: citation ~99%, fact coverage ~97%, abstention 100%

Agent Architecture (LangGraph)

flowchart TD
    U([Telegram Message]) --> BOT[Bot Front-end<br/>Language · Region · Commands]
    BOT --> R{Message type?}
    R -- Question --> RAG
    R -- /suggest --> SUG[Suggestion Flow<br/>PII guard → stage]
    R -- KB Review --> REV

    subgraph RAG [RAG Assistant · rag/]
        direction TB
        IDX[index.json<br/>kb/ embeddings] --> RET[Retrieve<br/>cosine top-K]
        RET --> J{Coverage?}
        J -- No --> ABS([Abstain<br/>не знаю])
        J -- Yes --> ANS[Answer<br/>норма · практика · citations]
    end

    subgraph REV [AI Revision Agent · LangGraph]
        direction TB
        L[loadPage] --> CI[classifyIntent]
        CI -- question --> AM[answerMsg]
        CI -- edit --> MP[makePlan]
        MP --> RB[reviseBody]
        RB --> CB[checkBody]
        CB -- invalid --> RB
        CB -- ok --> WF[writeFile]
        CB -- abort --> AB[abort]
    end

    subgraph PIPE [Practice Ingest Pipeline · LangGraph]
        direction TB
        IM[ingest_messages] --> TR[thread_reconstruct]
        TR --> EF[extract_facts · LLM]
        EF --> PG{pii_guard<br/>fail-closed}
        PG -- PII --> DROP([drop])
        PG -- clean --> CT[classify_topic]
        CT --> DM[dedup_merge]
        DM --> SF[stage_facts<br/>inbox/facts-*.md]
    end

    SF -. curator .-> IDX

    ANS --> END([Response + disclaimer])
    AM --> END
    WF --> END
    AB --> END
    SUG --> END

Frequently asked questions

What is Legalka KB?

A Telegram bot and knowledge base for legalisation in Poland. It answers strictly from verified sources — with references to laws and real applicant experience. If there's no answer — it honestly says "I don't know".

What topics does the knowledge base cover?

Temporary residence (karta pobytu), work, visas, banking, employment, real estate, taxes, ZUS, citizenship, family reunification, education, international protection — all for Poland.

What languages does the bot support?

The bot understands and responds in Ukrainian, English, Russian, and Polish.

How is answer accuracy ensured?

Every fact is marked as "norm" (with a law article reference) or "practice — applicant observations". If a question is not covered by the base — the bot abstains. Eval suite shows: citation ~99%, fact coverage ~97%, abstention 100%.