# mini_agent

> mini_agent — sergenes-mini-agent. Use this tool when you need to build a custom AI agent from scratch, solving problems that require flexible execution modes, such as local, remote, or mixed environments. It takes in minimal inputs, including execution mode and OpenAI SDK credentials, and outputs a functional AI agent capable of autonomous operation. Ideal for use cases where a lightweight, adaptable AI solution is necessary, such as prototyping or proof-of-concept projects.

Canonical page: https://skillsregistry.net/skills/sergenes-mini-agent  
JSON: https://api.skillsregistry.net/v1/skills/sergenes-mini-agent

## Description

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).

## Trust

- **Trust score (0–1):** 0.63
- **Verification tier:** scanned
- **Last scanned:** 2026-09-03

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** container
- **Runtime environment:** vm
- **Category:** ai-ml
- **Updated:** 2026-09-22

## Source

- **Source listing:** [GitHub](https://github.com/sergenes/mini_agent)

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "sergenes-mini-agent"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/sergenes-mini-agent` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/sergenes-mini-agent/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt
