sergenes/mini_agent

A minimal AI agent built from scratch — no agent framework, just Python, the OpenAI SDK, and a `while` loop. Accompanies the Medium article "Build Your Own AI Agent from Scratch." Three execution modes: `local` (Ollama only), `remote` (cloud provider), `mixed` (local orchestrates, delegates to remote).

29Stars on the repository
10Mods indexed here, across every type
8d agoLast push, which is what freshness is scored on
noneNo LICENSE: all rights reserved, so bodies are not copied

deploy

01

sergenes/mini_agent

Skill Claude CodeCodex

One-command iOS TestFlight and Android Play uploads via deployment-pipeline/release.py, plus infratools.py wrappers. Use when releasing, bumping build numbers, wiring agent-callable deploy tools, or editing files under deployment-pipeline/.

29 8d ago A 50 tokens

running-the-agent

02

sergenes/mini_agent

Skill Claude CodeCodex

How to run miniagent locally, remotely, or in mixed mode, including Ollama, env vars, MCP, interactive REPL, and provider fallback. Use when running agent.py, adding a provider, debugging tool calling, or setting up .env.

29 8d ago A 55 tokens

visual-check

03

sergenes/mini_agent

Skill Claude CodeCodex

Record and check iOS and Android UI flows with uiagent.py (cloud) or uiagentlocal.py (Ollama). Use when recording a visual baseline, running check or check-all, debugging simulator taps, or editing files under visual-testing/.

29 8d ago A 53 tokens

sergenes/mini_agent

Skill Claude CodeCodex

Default Android app architecture: MVVM, three Gradle modules, Jetpack Compose, Hilt, Coil, Ktor, Room, DataStore. Use when creating or changing Android, Kotlin, Jetpack Compose, Gradle modules, Activities, ViewModels, or Android libraries in an app that has not already chosen a different pattern.

29 8d ago A 71 tokens

ios-architecture

05

sergenes/mini_agent

Skill Claude CodeCodex

Default iOS and macOS app architecture: MVVM, SwiftUI, @Observable, async/await, URLSession. Use when creating or changing iOS, iPadOS, macOS, SwiftUI, ViewModels, Swift packages, or Xcode app targets that have not already chosen a different pattern.

29 8d ago A 67 tokens

new-project

06

sergenes/mini_agent

Skill Claude CodeCodex

Bootstrap a new product repository for agentic development. Use when starting a new app, empty repo, greenfield project, or when the user asks to stand up the factory, the start loop, or what to install before the first feature.

29 8d ago A 51 tokens

web-architecture

07

sergenes/mini_agent

Skill Claude CodeCodex

Default web app architecture: TypeScript, feature folders, a view / state / client split in the same spirit as MVVM. Use when creating or changing web UI, TypeScript/JavaScript frontend, React or similar SPA/SSR pages, CSS, or browser API clients in an app that has not already chosen a different pattern.

29 8d ago A 71 tokens