Skip to content
View maarkN's full-sized avatar
🤔
Whether you think you can, or you think you can't – you're right.
🤔
Whether you think you can, or you think you can't – you're right.

Organizations

@Doctor-X-Dev

Block or report maarkN

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
maarkN/README.md

whoami.ts

const marco = {
  role:      "Senior Full-Stack & AI Engineer",
  experience: "6+ years, most of it as the sole engineer or tech lead",
  focus:     ["backend architecture", "applied generative AI", "developer tooling"],

  stack: {
    languages: ["TypeScript", "Go", "Dart", "Python", "SQL"],
    backend:   ["Node.js", "NestJS", "FastAPI", "gRPC / Connect-RPC", "Kafka", "DDD", "CQRS"],
    frontend:  ["React", "Next.js", "Vue", "Nuxt", "Astro", "Tailwind"],
    mobile:    ["React Native", "Expo", "Flutter"],
    ai:        ["LangGraph", "LangChain", "RAG", "Qdrant", "pgvector", "MCP"],
    infra:     ["Kubernetes", "Docker", "AWS", "GCP", "Postgres", "Redis"],
  },

  shipped: [
    "a CRM backend rewritten TypeScript → Go in under two months, solo",
    "a VoIP platform on Asterisk that cut telephony cost ~60%",
    "a RAG platform indexing 246 government portals",
  ],

  currentlyLearning: ["distributed systems in Go", "LLM evaluation"],
  funFact: "I once inherited a React Native app declared impossible to update. It shipped a week later.",
};

🧰 Stack

Languages

TypeScript Go Python JavaScript Dart

Backend & Architecture

NestJS Node.js FastAPI gRPC Apache Kafka RabbitMQ

Frontend & Mobile

React Next.js Vue.js Nuxt Astro Tailwind CSS React Native Flutter

AI & Data

LangChain OpenAI Qdrant Elasticsearch PostgreSQL MongoDB Redis

Cloud & DevOps

Kubernetes Docker AWS Google Cloud Terraform GitHub Actions


🛰️ Web-access infrastructure for AI agents

Three projects, one thesis: AI agents can reason, but they still can't reliably reach the web. Anti-bot walls, messy HTML and untyped data break them. These close that gap, bottom to top.

Project What it does
🐹 cloudscraper-go Native Go client that fetches anti-bot–protected pages using real browser TLS/JA3·JA4 fingerprints (uTLS) — no Python, no headless browser. Concurrent crawler, Prometheus metrics, MCP server. Single static binary.
📦 cloudscraper.js npm-published Node/TypeScript SDK over the same problem: reusable hot sessions, an MCP server + LangChain tool, and clean Markdown output for LLMs.
🎯 jobradar-ai Agentic LangGraph pipeline that scrapes job boards, LLM-extracts a typed schema, indexes into Qdrant and ranks openings against a CV. mypy --strict, with an LLM evaluation harness wired into CI.

Also worth a look

Project What it does
☎️ frontdesk-ai Bilingual (EN/FR-CA) AI voice receptionist for Canadian service SMBs — answers overflow calls, qualifies, books and notifies. Go realtime telephony plane (Telnyx/Asterisk, barge-in, degradation ladder) + Python LangGraph agent, event-sourced on NATS JetStream, React 19 + Expo apps, full OTel/Grafana observability.
🌐 maarkn.dev My portfolio — Next.js 16, React 19, strict TypeScript, a RAG-powered assistant that answers questions about my work, and a three-theme design system. Self-hosted on Docker/Traefik/EC2.
🩻 radflow.ai Radiology worklist & dictation cockpit — NestJS microservices over NATS JetStream.

📊 Stats

Followers Public repos Stars



Activity graph

🌍 Open to

I'm looking for a senior full-stack, backend or AI engineering role with an international team.

  • 🇨🇦 🇮🇪 🇩🇪 Relocation — actively pursuing permanent residence in Canada (Express Entry / PNP, NOC 21231) and open to employer-supported relocation to Ireland or Germany.
  • 🌐 Remote, worldwide — available immediately as a B2B contractor through my own company, no visa or sponsorship required.
  • 🗣️ Portuguese (native) · English (professional working proficiency)

📬 Best way to reach me: LinkedIn or the contact form at maarkn.dev.

Pinned Loading

  1. cloudscraper-go cloudscraper-go Public

    Native Go library & CLI to fetch anti-bot–protected pages using real browser TLS/JA3·JA4 fingerprints (uTLS) — no Python, no headless browser for the common cases. Single static binary.

    Go

  2. cloudscraper.js cloudscraper.js Public

    Agent-ready Node.js/TypeScript client for Cloudflare-protected sites: reusable hot sessions, an MCP server + LangChain tool, and clean Markdown for LLMs. Powered by the Python cloudscraper engine.

    TypeScript 3

  3. jobradar-ai jobradar-ai Public

    Agentic LangGraph pipeline that scrapes job boards, LLM-extracts a typed schema, indexes in Qdrant and ranks openings against a CV — filtering EU/CA visa-sponsored senior roles. Consumes cloudscrap…

    Python

  4. maarkn.dev maarkn.dev Public

    Personal portfolio of Marco Filho (@maarkn) — senior fullstack engineer. Next.js 16, TypeScript, Tailwind v4, three-theme design system (Light/Dark/Dev), multilanguage (EN/PT-BR).

    TypeScript

  5. radflow.ai radflow.ai Public

    AI-powered radiology worklist & dictation cockpit — NestJS microservices, NATS JetStream, HL7/DICOM, Python LLM service. Demo project, zero PHI.

    TypeScript

  6. frontdesk-ai frontdesk-ai Public

    Bilingual (EN/FR-CA) AI voice receptionist for Canadian service SMBs — answers overflow calls, qualifies, books and notifies. Go + Python (LangGraph) + React/Expo, event-sourced on NATS.

    Go