Cloudgeni-ai/opengeni

Última atividade de origem registrada: 29 de outubro de 2026 às 22:19

Catálogo do SkillsMP atualizado: 5 de novembro de 2026 às 19:57

skills coletadas: 29

Estrelas no GitHub: 212
Forks no GitHub: 20

Instalar com um assistente de IA

Copie este prompt para o assistente de IA que você usa.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/Cloudgeni-ai/opengeni.

README do repositório

Arquivo de origem do README: README.md

Ler o README original

Expandir README completo

<a href="https://opengeni.ai"> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs-site/logo/dark.svg"> <img src="docs-site/logo/light.svg" alt="Opengeni" width="320"> </picture> </a> <h3 align="center">Production-ready self-hostable agentic service.</h3> Durable sessions · human approvals · governed memory · your choice of compute <a href="https://app.opengeni.ai">Start free at app.opengeni.ai →</a> <a href="https://docs.opengeni.ai/quickstart">Quickstart</a> · <a href="https://docs.opengeni.ai">Docs</a> · <a href="https://docs.opengeni.ai/guides/self-host">Self-host</a> · <a href="https://github.com/Cloudgeni-ai/opengeni/issues">Issues</a> <a href="https://github.com/Cloudgeni-ai/opengeni/actions/workflows/ci.yml"><img src="https://github.com/Cloudgeni-ai/opengeni/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://www.npmjs.com/package/@opengeni/sdk"><img src="https://img.shields.io/npm/v/@opengeni/sdk?label=%40opengeni%2Fsdk" alt="npm"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" alt="License: Apache-2.0"></a> --- Opengeni is a production-ready agentic service: it runs AI agents that do real work, keeps a session going for hours or days, records every step in a replayable event log, stops for a human when an action needs approval, and puts each session either in a managed sandbox or directly on a machine you own. Opengeni is not the agent; it is everything the agent needs around it. Give agents work from the web app and follow along, or call the same session API from your own product and let Opengeni hold the state, history, approvals, and outputs. It grew out of two years of running agents against production cloud infrastructure at [Cloudgeni](https://cloudgeni.ai). ## Get started **The fastest way is the managed service.** Sign up at [app.opengeni.ai](https://app.opengeni.ai), name your organization, connect a model (a ChatGPT/Codex or SuperGrok subscription, a provider key, or prepaid credits), and start your first session. Nothing to deploy. The [quickstart](https://docs.opengeni.ai/quickstart) walks through it. Prefer to run it yourself? Everything is open source. Jump to [Run it locally](#run-it-locally) for a one-command dev stack, or to [Self-host](https://docs.opengeni.ai/guides/self-host) for production. ## Features - **Durable, replayable sessions.** Every event lands in Postgres. Live streams backfill from it, so a browser reload, a new client, or an audit replays the same history. - **Sessions that finish the job.** Give a session a goal with success criteria. The agent keeps working until it completes the goal with evidence, pauses with a rationale, or a human interrupts. - **Humans in the loop.** Tool approvals gate risky actions. Agents can ask structured questions and resume the exact tool call after the answer, even across restarts. - **Run anywhere.** A managed sandbox (Docker, Modal, or a cloud provider) or a **Connected Machine**: your laptop, build server, or GPU box, enrolled once and driven directly. Machines only dial out and receive no Opengeni credentials. - **Agent Knowledge.** Files, retained sources, and useful findings in one searchable library, with personal and workspace ownership and optional review before anything is published. - **Integrate into your product.** Embed the full conversation with the `SessionConversation` React component behind a packaged, tenant- and user-scoped proxy on your server. Your organization API key stays there. - **Managed or self-hosted.** Use [app.opengeni.ai](https://app.opengeni.ai) with nothing to run, or deploy the same API, web app, workers, Helm chart, and reference Terraform for Azure, AWS, and GCP yourself. All of it is Apache-2.0. ## Run it locally Repository changes land through the [merge batcher](docs/merge-batcher.md): queued PRs are tested together on the combined tree and each lands as one squash commit. Main runs the full suite on a cadence and is the release gate. For development, or to evaluate Opengeni before self-hosting. You need [Bun at the exact version in `.bun-version`](.bun-version), Git, curl, Docker, [rustup](https://rustup.rs), a C compiler (Xcode Command Line Tools on macOS or `build-essential` on Debian/Ubuntu), and an OpenAI or Azure OpenAI key. ```bash git clone https://github.com/Cloudgeni-ai/opengeni.git cd opengeni cp .env.example .env # add your model credentials bun run dev ``` Open http://127.0.0.1:3000, describe a task, and watch the session run. `bun run dev` installs dependencies, starts Postgres, NATS, Temporal, and object storage, runs migrations, and starts the API, workers, and web app. By default the agent runs commands directly on your machine (the `local` sandbox), not in an isolated container, so the API and web app listen only on 127.0.0.1. Set `OPENGENI_SANDBOX_BACKEND=docker` to run the agent in the local sandbox image instead. See [Local development](docs/local-development.md) for manual startup, configuration, network exposure, and the native (no Docker) path. ## Desktop app Opengeni for macOS, Windows and Linux: your sessions, chat and inbox in a native window, with notifications and one click to let agents use the computer you're on. ```bash # macOS brew install --cask cloudgeni-ai/tap/opengeni # macOS or Linux (deb, rpm or AppImage, picked for your system) curl -fsSL https://<your-opengeni-server>/desktop/install.sh | sh ``` On Windows, download `Opengeni-<version>-windows.exe` from the newest [`desktop-v` release](https://github.com/Cloudgeni-ai/opengeni/releases?q=desktop-v&expanded=true). The web app's account menu has the same downloads under **Desktop app**. Every way of installing updates itself afterwards. ## Use it from your code and product **Let your coding agent do it.** Install the Opengeni plugin, then ask your agent to add Opengeni to your product: ```bash # Claude Code claude plugin marketplace add Cloudgeni-ai/opengeni claude plugin install opengeni@opengeni --scope user # Codex (CLI, IDE, and the Codex app) codex plugin marketplace add Cloudgeni-ai/opengeni codex plugin add opengeni@opengeni ``` In Cursor, use **Customize → From GitHub Repository** with this repository. The plugin adds the Opengeni skills and connects your agent to your organization over MCP (sign in once in the browser). See the [plugin guide](https://docs.opengeni.ai/guides/developer-plugin). **Or wire it yourself** — one server route and one component: ```ts // app/api/opengeni/[...path]/route.ts (server only; the key stays here) import { Opengeni } from "@opengeni/sdk/chat"; import { createSessionProxyRoute } from "@opengeni/sdk/next"; const og = new Opengeni({ apiKey: process.env.OPENGENI_API_KEY! }); export const { GET, POST, PUT, PATCH, DELETE } = createSessionProxyRoute(og, { resolve: async (request) => { const me = await authenticate(request); // your product's own auth if (!me) return new Response("Unauthorized", { status: 401 }); return { user: me.id, tenant: me.teamId }; // workspaces and members are created on first use }, createSession: (input) => input, }); ``` ```tsx // Browser import { OpenGeniChat } from "@opengeni/react"; import "@opengeni/react/compiled.css"; <OpenGeniChat baseUrl="/api/opengeni" />; ``` Follow [Embed manually](https://docs.opengeni.ai/embed-manually) for the details, then the [TypeScript SDK](packages/sdk/README.md) and [React components](packages/react/README.md). [Northstar support](examples/northstar-support) is a runnable SaaS embed with a product MCP server. ## How it works "Agent" is one word for at least ten different jobs. A model is a function from tokens to tokens: it forgets everything between calls, has no idea what it is allowed to do, and has no obligation to keep working until the job is done. Everything above it exists to turn that into work that finishes, can be trusted with real systems, and can be explained afterwards. Opengeni is built as those layers. ```text ┌───────────────┐ ┌───────────────────────────────────────────────────────┐ │ │ │ 10 SURFACES console · embedded UI · Slack · │ │ 8 GOVERNANCE │ │ voice · SDK · API │ │ │ ├───────────────────────────────────────────────────────┤ │ identity │ │ 9 KNOWLEDGE scoped retrieval · reviewed │ │ tenancy │ │ learning · never mixed with chat │ │ permissions │ ├───────────────────────────────────────────────────────┤ │ secrets │ │ 7 DURABLE STATE sessions · turns · goals · │ │ approvals │ │ & ORCHESTRATION recovery · human-in-the-loop │ │ audit │ ├───────────────────────────────────────────────────────┤ │ │ │ 6 COMPUTE sandboxes · browsers · │ │ + │ │ your own machines │ │ │ ├───────────────────────────────────────────────────────┤ │ OBSERVABILITY │ │ 5 TOOLS one gateway · MCP · connections · │ │ & COST │ │ credentials outside the prompt │ │ │ ├───────────────────────────────────────────────────────┤ │ every call │ │ 4 AGENT LOOP cache-stable prompt · gradual │ │ records what │ │ tool disclosure · exact history │ │ it cost and │ ├───────────────────────────────────────────────────────┤ │ who pays │ │ 3 MODEL ROUTING allowed models · fallback · │ │ │ │ capacity waits · billing │ │ │ ├───────────────────────────────────────────────────────┤ │ │ │ 1-2 INFERENCE any provider · any wire format · │ │ │ │ swappable mid-conversation │ └───────────────┘ └───────────────────────────────────────────────────────┘ ``` **Rent the edges, own the middle.** Models, provider APIs, and the raw compute box change too fast to own, so every one of them is a swappable boundary. Durable state, governance, and knowledge are where your workflows, permissions, audit record, and institutional memory actually live, so they sit in a Postgres database you operate, export, and can leave with. ## Documentation | I want to... | Read | | ------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | Start on the managed service | [Quickstart](https://docs.opengeni.ai/quickstart) | | Run it locally | [Local development](docs/local-development.md) | | Deploy to production | [Self-host](https://docs.opengeni.ai/guides/self-host) · [Deployment guide](docs/deployment.md) | | Add agents to my product | [Product integration](docs/product-integration.md) · [SDK reference](https://docs.opengeni.ai/reference/sdk) | | Run sessions on my own hardware | [Connect a machine](https://docs.opengeni.ai/guides/connect-a-machine) · [Connected Machines](docs/connected-machines.md) | | Call the HTTP API directly | [HTTP API overview](docs/http-api.md) | | Configure models and providers | [Model providers](docs/model-providers.md) | | Give agents repository access | [GitHub App](docs/github-app.md) | | Understand goals, approvals, memory | [Goals](docs/goals.md) · [Human input](docs/human-input.md) · [Knowledge](docs/knowledge.md) | | Understand the internals | [Architecture](docs/architecture.md) · [Run lifecycle](docs/run-lifecycle.md) · [Docs map](docs/README.md) | | See what is planned | [Roadmap](docs/roadmap.md) | The public product docs live at [docs.opengeni.ai](https://docs.opengeni.ai), and the thinking behind the layers above is on the [Opengeni blog](https://opengeni.substack.com/). The [Cloudgeni Infrastructure Agents Guide](https://github.com/Cloudgeni-ai/infrastructure-agents-guide) covers patterns for infrastructure-focused agents. ## Built with Bun · Hono · React and Vite · Temporal · Postgres with pgvector · NATS · OpenAI Agents SDK · a Rust agent and relay for Connected Machines ## Security Do not expose a production deployment without a deliberate access mode, tested database role posture, rate limits, and a reviewed sandbox credential policy. See the [security boundary](docs/deployment.md#security-boundary) and report vulnerabilities through [SECURITY.md](SECURITY.md). ## Contributing Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) for setup, checks, and the pull request workflow, and [AGENTS.md](AGENTS.md) if you work on Opengeni itself. ```bash bun run typecheck bun test ``` ## License [Apache-2.0](LICENSE). Optional curated Skills under `packages/runtime/src/curated_skill_library` carry their own provenance and license metadata; HashiCorp-derived Terraform guidance is MPL-2.0 and is never mounted by default.

Carregando o README do repositório…

Skills neste repositório

Desenvolvedores de software Analistas de garantia de qualidade de software e testadores Analistas de pesquisa de mercado e especialistas em marketing Analistas de segurança da informação

5 categorias ocupacionais · 28% classificado

skill

ocupação

descrição

atualizado

opengeni-help

sem classificação

Answer questions about Opengeni setup, using it on a phone or computer, doing settings for the person in chat, product integration, SDK/API behavior, billing, GitHub access, and development setup. Read the official product docs before making product-specific…