LibreAI / AI Agents / gini-agent
// agents · Open-Curiosity/gini-agent

gini-agent

Gini: a personal agent runtime that remembers, learns skills, and reaches you with the right control in time.

★ 1.9k stars⑂ 774 forksMITupdated 2026-07
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

gini-agent is an open-source ai agents project by Open-Curiosity (Open-Curiosity/gini-agent on GitHub). It has 1,934 GitHub stars and 774 forks, is released under the MIT license, and was last updated on GitHub on 18 July 2026.

GitHub stars
1,934
Forks
774
License
MIT
Last updated on GitHub
18 July 2026
Category
AI Agents
Listing
Full install guide
// how it works

How it works

  1. Clarify your goal

    Decide which model provider the agent will use, from OpenAI, Anthropic, Bedrock, Azure, OpenRouter, DeepSeek, Codex OAuth, or a local server.

  2. Get the project

    Install Gini with the one-line installer, which on macOS also enables autostart and opens the setup page.

  3. Install and configure

    Complete the setup form with your chosen provider's credentials, or run gini setup then gini start on Linux.

  4. Run your first task

    Chat with the agent, approve tool use when prompted, and manage runs, jobs, and memory from the web app or CLI.

// features

Why people love it

Runtime-as-gateway architecture

One Bun process per instance owns state and work, while web, CLI, mobile, MCP, and messaging clients share one authenticated API contract.

Persistent everything

Chat, runs, tasks, approvals, traces, audit events, jobs, memories, and skills persist across sessions and clients.

In-chat actionable controls

Secure credential fields, sign-in handoffs into the agent's browser, choice prompts, and confirm-before-send controls appear inline instead of prose instructions.

Memory with embeddings and reranking

Local embeddings, reranking, and voice-message transcription are built in, and memory is retained, recalled, and reviewed by the runtime.

Skill learning

Gini improves its own skills from task outcomes through a documented reward, attribution, and human-gated review process.

Parallel instances and remote access

Multiple isolated instances with their own ports and state, plus tunnel options (including Tailscale, ngrok, and Cloudflare) and migration from OpenClaw.

Advertisement
// run it

Run it yourself

  1. Clone the project (source install alternative)

    Most users use the one-line installer; source runs use Bun.

    git clone https://github.com/Open-Curiosity/gini-agent.git
    cd gini-agent
  2. Install from source and start

    Install dependencies with Bun, then install and start an instance derived from the directory.

    bun install
    bun run gini install
    bun run gini start
  3. Or use the one-line installer, then configure a provider

    After install, open the web app at 127.0.0.1:7777 and set a provider, for example OpenAI.

    curl -fsSL https://raw.githubusercontent.com/Open-Curiosity/gini-agent/main/scripts/install.sh | bash
    gini provider set openai gpt-5.4-mini # model names per README provider section
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains it?

It is maintained by Open-Curiosity on GitHub.

Is it free to use?

Yes, Gini is MIT-licensed and free to run. You pay your chosen model provider; local OpenAI-compatible servers are supported if you want no API spend.

Does it need a paid API key?

Usually yes: most providers need an API key or OAuth login (Codex), though the local provider can use a self-hosted model server with no key.

How does it compare to a well-known alternative?

Chatbot-style agents keep state in the conversation; Gini's runtime is the system of record, with persistent tasks, approvals, memory, and audit events shared across web, CLI, and mobile clients.

How do I get started?

Run the one-line installer, complete the /setup page with a provider, and open the web app at http://127.0.0.1:7777.

// keep exploring

Similar tools

AI Agents

hindsight

Agent memory that learns — so your agents get smarter over time.

★ 47.0k starsMIT
View guide →
Agents

qwen-audio-agent

Real-time voice runtime that keeps AI agents talking, working, and present.

★ 2.8k starsApache-2.0
View guide →
AI Agents

AppAgent

AppAgent — Tencent's multimodal agent that learns smartphone apps by exploration, then operates them.

★ 6.9k starsMIT
View guide →
Agents

tons-of-skills-marketplace

Model-agnostic marketplace of agent skills with a harness-free canonical layer.

★ 2.8k starsMIT
View guide →
Agents

yao-meta-skill

YAO: rigorous engineering, evaluation, and governance for reusable agent skills.

★ 2.7k starsMIT
View guide →
Agents

openakita

Open-source AI assistant framework with skills and an OpenClaw-style agent core.

★ 2.0k starsAGPL-3.0
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if gini-agent is not the right fit.

Get gini-agent

Free and open — grab the source, star the repo, and start creating.