Summary

Gini Agent provides a persistent, learning personal agent that acts as a unified system of record for conversations, tasks, memory, and tools. It aims to offer a more integrated experience than simple chat interfaces or tool collections, empowering users with a continuously improving AI assistant.

How It Works

The core architecture centers on a single Bun process per instance acting as the gateway, managing state, the agent loop, tools, memory, and jobs. Various clients, including a Next.js web UI, CLI, and mobile apps, interact with this gateway via a standardized authenticated API. This design centralizes state and execution, simplifying management and ensuring consistency across interaction surfaces.

Quick Start & Requirements

• Installation is streamlined via a curl script: curl -fsSL https://raw.githubusercontent.com/Lilac-Labs/gini-agent/main/scripts/install.sh | bash.
• On macOS, the installer automatically configures autostart and opens the web setup page. Linux autostart is not yet implemented.
• Running from source requires bun install and bun run gini start.
• Requires LLM API keys (OpenAI, Azure, Anthropic, Bedrock, etc.) or Codex authentication.
• Links: Installer script, CONTRIBUTING.md, ROADMAP.md, SECURITY.md.

Highlighted Details

• Unified Runtime: A single Bun process per instance manages all agent state, loops, tools, memory, and jobs.
• Extensive Provider Support: Integrates with numerous LLM providers including OpenAI, Azure OpenAI, Anthropic, Bedrock, OpenRouter, DeepSeek, Codex, and local OpenAI-compatible servers.
• Local Capabilities: Includes default local models for embeddings, reranking, and speech-to-text.
• Parallel Instances: Supports running multiple isolated agent instances concurrently, each with its own state, ports, and logs.
• Openclaw Migration: Provides tools to import existing openclaw agent states.

Maintenance & Community

Contributions are welcomed via CONTRIBUTING.md. Security issues should be reported privately per SECURITY.md. The project roadmap is detailed in ROADMAP.md. No explicit community channels like Discord or Slack are listed.

Licensing & Compatibility

The project is released under the MIT license, permitting broad use, including commercial applications and integration with closed-source software.

Limitations & Caveats

Automatic startup is currently limited to macOS. Messaging channel integrations (Telegram, Discord) are not actively maintained, with native web and iOS apps being the primary development focus. A specific macOS launchd behavior may require manual intervention (gini autostart kick) after certain process terminations.