From b3079776392f02dd8576bed46ad5e0a0e52f93d9 Mon Sep 17 00:00:00 2001 From: Reza Yaghobi Date: Sat, 29 Aug 2026 18:41:15 +0330 Subject: [PATCH] Add top-level README --- README.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..17e1455 --- /dev/null +++ b/README.md @@ -0,0 +1,24 @@ +# agents + +This repository holds my agentic tasks and workflows — automation stacks built with tools like n8n, OpenHands, and OpenClaw. + +## Projects + +### [`n8n-Bale-file-fetch`](./n8n-Bale-file-fetch) + +An n8n workflow that acts as a file-retrieval agent for [Bale](https://bale.ai) (a Telegram-like Iranian messaging app). Type a natural-language request — e.g. *"grab the devops PDFs from this channel"* — and the workflow parses the intent with an LLM, fetches matching files from a Bale channel via its bot API, and saves them to disk. + +Built as a take-home task for a job interview, focused on demonstrating how to scope an LLM's role narrowly (intent parsing only) while keeping the rest of the pipeline — fetching, filtering, downloading — as plain, deterministic logic. + +See inside the folder for: +- **SETUP.md** — how to stand it up (Bale bot/channel creation, n8n import, credentials, known gotchas) +- **HOW_IT_WORKS.md** — architecture and data flow, step by step +- **NODE_DESCRIPTIONS.md** — talking points for walking through the workflow live + +### [`.freebuff`](./.freebuff) + +*(add a short description here once you're ready — leaving as a placeholder for now)* + +## Notes + +Workflow exports and configs in this repo have credentials and IDs replaced with placeholders (e.g. `YOUR_BOT_ID`) before committing. Anyone running a workflow locally needs to drop their own values back in.