Skip to content
View augbastos's full-sized avatar

Block or report augbastos

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
augbastos/README.md

Augusto Bastos

AI Engineer β€” multi-agent orchestration, MCP servers, and the production plumbing underneath. Open source, runnable, documented.

πŸ“ Limerick, Ireland Β· Portfolio Β· LinkedIn Β· Upwork Β· Email

I design systems where several models, tools and services cooperate on one real problem β€” agent councils that propose, debate and adversarially verify; MCP servers that give an LLM safe hands on real APIs; and the unglamorous layer underneath (multi-tenant data, auth, billing, deploys) that a real product needs to exist.

Most product source is private β€” it's commercial. Everything below is open, runnable, or written up as a case study you can read end to end.

devcard β€” live AI-assisted coding stats for augbastos

A live card rendered from my own coding hooks. Built with devcard β€” MIT, works with any agent that commits.


Selected work

SCPE β€” verifiable provenance for what an agent produced

When a pull request arrives from someone you don't know β€” a person, or increasingly an AI agent β€” trust rests on a username and reading the diff by eye. SCPE adds a signed envelope proving who produced a contribution and that nothing was tampered with, verified offline with no protocol server and no new accounts, using signing keys the contributor's git host already publishes.

I wrote the spec and three independent verifiers β€” Python, Go and Rust β€” held to the same verdict across 18 normative test vectors by a differential test, plus 8 adversarial ones. Ships as a GitHub Action that seals or gates pull requests.

The protocol runs on itself: this repo and seven others fail a pull request that arrives with no AI-use disclosure β€” including the ones my own agents open.

Apache-2.0 β†’ Site Β· Repo Β· PyPI

Wavr β€” explainable multi-modal sensor fusion, privacy-first

Fuses network scan, WiFi CSI, camera pose and mmWave radar into one explainable room-occupancy state: confidence = strength (trust weight Γ— the source's own confidence Γ— freshness decay), and the dashboard always shows why it believes what it believes.

Ships its own MCP server, so an LLM agent can ask the house what's happening. Loopback-only by default, camera frames never stored, and every sensor path mock-tested β€” camera, mmWave, WiFi CSI, BLE, and the whole network-discovery stack. Runs with no hardware at all: off-localhost the frontend self-switches to a simulator.

Python 3.11 Β· FastAPI Β· AGPL-3.0 β†’ Repo

🧾 deputy-mcp β€” self-hosted MCP server for Deputy (workforce management)

An alternative to the hosted Deputy connectors where your token never leaves your machine. Three auth modes (API token, OAuth 2.0 with loopback flow, iCal fallback) and self-service /my/* endpoints, so a plain employee token works without manager permissions β€” with graceful degradation when access is denied.

Tested end to end against a mocked Deputy API; writes stay locked behind an opt-in flag.

Python Β· FastMCP β†’ Repo

βš–οΈ council β€” a deliberation engine that distrusts its own consensus

Four lenses on a question, five on a repo (Architect, QA, Security, Docs-DX, Maintainer), propose independently and debate; then the pipeline computes convergence β€” which claims multiple lenses reached alone β€” adversarially attacks the top claims with dedicated refuters, and only lets a neutral chair synthesize from what survived.

Runs against any repo or question, heterogeneous models per lens, and a deterministic mock backend runs the full pipeline offline. Source private for now β€” happy to walk through it.

πŸ›οΈ etica β€” a book production pipeline in code

Public-domain text in, print-ready book out. A headless Chromium is the typesetter: Paged.js over a stylesheet produces a 6Γ—9 PDF with running heads and real page breaks, alongside EPUB3/Kindle and deterministic generative cover art β€” the same book built from one source in six languages.

The pipeline and a Part I sample are public; the full adapted prose is a separate paid edition.

β†’ Repo


Products & case studies

Lucky Cat β€” multi-tenant restaurant SaaS

Two full apps on one backend: Ownly (owner dashboard β€” shifts, payroll, stock, cash-up, live orders board) and Tillr (customer ordering PWA with real-time tracking). Postgres Row-Level Security as the isolation boundary, Stripe Connect wired for split payments, Cloudflare at the edge.

First end-to-end version built solo in under two months (June–July 2026); still under active development. Two demo tenants run on the same schema a real store would get, and the card rail is proven end to end in Stripe live mode β€” infrastructure proven, not a customer: no restaurant has run on it.

β†’ Case study Β· Ownly demo Β· Tillr demo

PitchPilot β€” field-sales companion with a RAG copilot

A white-label app for door-to-door reps. Its core is Wingman, a retrieval-augmented copilot (Supabase pgvector + Gemini) that answers a rep's question from the product's own playbook β€” grounded and cited.

The case study is the honest version: an IVFFlat recall collapse on a tiny corpus, a thinking-token budget eating the output, and a cost-ordered model fallback under quota. What actually broke, and how I fixed it.

β†’ Case study Β· Live demo

πŸ”Ž rag-demo β€” the retrieval pipeline, runnable

A minimal, clone-and-run RAG pipeline: chunk β†’ embed β†’ pgvector β†’ grounded answer that refuses to invent. docker compose up, a local sentence-transformers model for keyless indexing, pytest, and a match_chunks() SQL function shaped like a Supabase RPC. The inspectable code behind my copilots.

β†’ Repo

πŸͺͺ devcard β€” live dev stats card for the AI coding era

The card at the top of this page. A local hook captures real AI-assisted coding output (not editor time) and syncs an anonymized copy β€” language and line counts, never project names or code β€” to a Cloudflare Worker + D1 that renders an embeddable SVG: i18n by viewer language, auto dark/light, pinned repos with live stars.

It hooks git itself, so it works with Claude Code, Codex, Cursor, local models β€” anything that commits. One-command setup.

MIT β†’ Repo

Also: scrcpy-tray β€” your Android phone in the Windows tray, one click to mirror. MIT.


Stack

Python FastAPI PostgreSQL pgvector Supabase TypeScript React Cloudflare Docker Stripe Claude Gemini

Also working with: multi-agent orchestration Β· MCP (Model Context Protocol) Β· RAG pipelines (pgvector, sentence-transformers) Β· Postgres Row-Level Security Β· Supabase Edge Functions Β· Stripe Connect Β· agent hooks and CI-gated agent workflows


Get in touch

Open to freelance work and AI-engineering roles β€” multi-agent systems, MCP servers, RAG pipelines, and full-stack products built to ship.

Pinned Loading

  1. wavr wavr Public

    Multi-modal home sensing β€” WiFi CSI + network scan + camera CV + mmWave fused into explainable room occupancy and a position/posture radar over a floor plan you draw. Privacy-first, loopback-only, …

    Python

  2. devcard devcard Public

    Live, embeddable dev stats card for the AI coding era β€” works with Claude Code, Codex, Cursor, aider, local models, anything that commits

    TypeScript

  3. scpe scpe Public

    Verifiable provenance for digital artifacts. Prove who made a contribution and that nothing was tampered with - offline, no server, no accounts.

    Python 1

  4. deputy-mcp deputy-mcp Public

    Open-source, self-hosted MCP server for Deputy (deputy.com) β€” query your roster, timesheets and shifts from Claude or any MCP client. Token / OAuth / iCal auth; runs locally, your data stays home.

    Python

  5. scrcpy-tray scrcpy-tray Public

    Your Android phone in the Windows tray: click to mirror, screenshot straight to the clipboard. A small third-party companion for scrcpy.

    PowerShell