# Open-Curiosity/gini-agent

The agent that remembers and learns.

Repository: https://github.com/Open-Curiosity/gini-agent
Canonical: https://ross.abutalabs.com/products/gini-agent
Language: TypeScript
License: MIT
License Family: permissive
Topics: agent, agent-runtime, ai-agent, bun, llm, local-first, mcp, nextjs, personal-agent, typescript
Last push: 2026-07-18T05:15:42+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 93, release rhythm 87, longevity 8
- inputs: {"age_days": 120, "days_push": 46, "days_rel": 86, "gap_med": 8.0, "n_releases_24m": 3}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1637, forks 593 (observed 2026-08-28T04:05:14.369341+00:00)

## What it is
Gini Agent is a personal AI agent runtime that remembers conversations, learns skills from task outcomes, and exposes chat, CLI, web, and mobile surfaces backed by a single Bun gateway process. It supports multiple LLM providers, MCP tools, memory with embeddings, human approval gates, and remote access via tunnels.

## Use cases
- run a personal AI agent that remembers context across sessions
- self-host an LLM agent with memory and skill learning
- control an agent remotely from a phone
- give an agent MCP tools with human approval gates
- audit agent runs, tasks, and traces
- deploy a headless agent in Docker with browser automation

## When to choose
- you want a local-first personal agent with persistent memory and self-improving skills
- you need a full agent runtime with audit, approvals, and multi-client access rather than a chat box
- you want to self-host an agent reachable via Tailscale, ngrok, or Cloudflare tunnels

## When to avoid
- you only need a simple chatbot or single-shot LLM script
- you want a lightweight library to embed agents in your own app rather than a full product runtime
- you cannot run a persistent gateway process or self-host services

## Facets
- artifact type: application
- maturity: active
- function: agent-framework, mcp, llm-inference, rag, chat-interface, workflow-automation, auth, monitoring
- domain: large-language-models, developer-tools, self-hosted
- platform: bun, self-hosted, cross-platform, cli
- tags: personal-agent, agent-runtime, local-first, memory, skill-learning, nextjs, expo, remote-access, tunneling, audit-trail, ai-agents, automation, nodejs, web-server, docker, mobile

## Member repositories
- Open-Curiosity/gini-agent (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:14.369341+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:46:39.954011+00:00, confidence not recorded.
  - readme: https://github.com/Open-Curiosity/gini-agent (fetched 2026-08-28T04:05:14.369341+00:00, sha 318e31df7317)
- Data as of 2026-08-30T08:39:29.467469+00:00.