nanoinfra 0.3.0__tar.gz

nanoinfra-0.3.0/.gitignore

@@ -0,0 +1,104 @@
+# Project-specific
+.worktrees/
+.worktree/
+.assets
+.docs
+.env
+.web
+.orion
+
+# Claude / AI assistant artifacts
+docs/superpowers/
+docs/plans/
+/plans/
+
+# webui (monorepo frontend)
+webui/node_modules/
+webui/dist/
+webui/coverage/
+webui/.vite/
+*.tsbuildinfo
+
+# Python bytecode & caches
+*.pyc
+*.pyo
+*.pyd
+*.pyw
+*.pyz
+__pycache__/
+*.egg-info/
+*.egg
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.pytype/
+.dmypy.json
+dmypy.json
+.tox/
+.nox/
+.hypothesis/
+
+# Build & packaging
+dist/
+build/
+*.manifest
+*.spec
+pip-wheel-metadata/
+share/python-wheels/
+
+# Test & coverage
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+*.cover
+
+# Lock files (project policy)
+poetry.lock
+uv.lock
+
+# Jupyter
+.ipynb_checkpoints/
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+# Linux
+.directory
+
+# Editors & IDEs (local workspace / user settings)
+.vscode/
+.cursor/
+.idea/
+.fleet/
+*.code-workspace
+*.sublime-project
+*.sublime-workspace
+*.swp
+*.swo
+*~
+nano.*.save
+
+# Environment & secrets (keep examples tracked if needed)
+.env.*
+!.env.example
+
+# Logs & temp
+*.log
+logs/
+tmp/
+temp/
+*.tmp
+exp/
+.playwright-mcp/
+bridge/node_modules/
+webui/.verify-*

nanoinfra-0.3.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025-present Xubin Ren and the nanobot contributors
+Copyright (c) 2026 Alberto Ferrer and the nanoinfra contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nanoinfra-0.3.0/PKG-INFO

@@ -0,0 +1,419 @@
+Metadata-Version: 2.4
+Name: nanoinfra
+Version: 0.3.0
+Summary: A lightweight personal AI assistant framework
+Author: Xubin Ren, the nanobot contributors, Alberto Ferrer
+License: MIT
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES.md
+Keywords: agent,ai,chatbot
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: anthropic<1.0.0,>=0.100.0
+Requires-Dist: chardet<6.0.0,>=3.0.2
+Requires-Dist: croniter<7.0.0,>=6.0.0
+Requires-Dist: ddgs<10.0.0,>=9.5.5
+Requires-Dist: defusedxml<1.0.0,>=0.7.1
+Requires-Dist: dulwich<1.0.0,>=0.22.0
+Requires-Dist: filelock>=3.25.2
+Requires-Dist: httpx<1.0.0,>=0.28.0
+Requires-Dist: jinja2<4.0.0,>=3.1.0
+Requires-Dist: json-repair<1.0.0,>=0.57.0
+Requires-Dist: loguru<1.0.0,>=0.7.3
+Requires-Dist: lxml-html-clean<1.0.0,>=0.4.0
+Requires-Dist: mcp<2.0.0,>=1.26.0
+Requires-Dist: oauth-cli-kit<1.0.0,>=0.1.6
+Requires-Dist: openai>=2.8.0
+Requires-Dist: openpyxl<4.0.0,>=3.1.0
+Requires-Dist: packaging>=24.0
+Requires-Dist: prompt-toolkit<4.0.0,>=3.0.50
+Requires-Dist: pydantic-settings<3.0.0,>=2.12.0
+Requires-Dist: pydantic<3.0.0,>=2.12.0
+Requires-Dist: pypdf<6.0.0,>=5.0.0
+Requires-Dist: python-docx<2.0.0,>=1.1.0
+Requires-Dist: python-pptx<2.0.0,>=1.0.0
+Requires-Dist: pyyaml<7.0.0,>=6.0
+Requires-Dist: questionary<3.0.0,>=2.0.0
+Requires-Dist: readability-lxml<1.0.0,>=0.8.4
+Requires-Dist: rich<15.0.0,>=14.0.0
+Requires-Dist: tiktoken<1.0.0,>=0.12.0
+Requires-Dist: typer<1.0.0,>=0.20.0
+Requires-Dist: tzdata>=2025.2
+Requires-Dist: watchfiles<2.0.0,>=1.1.1
+Requires-Dist: websocket-client<2.0.0,>=1.9.0
+Requires-Dist: websockets<17.0,>=15.0
+Provides-Extra: api
+Requires-Dist: aiohttp<4.0.0,>=3.9.0; extra == 'api'
+Provides-Extra: azure
+Requires-Dist: azure-identity<2.0.0,>=1.19.0; extra == 'azure'
+Provides-Extra: bedrock
+Requires-Dist: boto3>=1.43.0; extra == 'bedrock'
+Provides-Extra: dev
+Requires-Dist: aiohttp<4.0.0,>=3.9.0; extra == 'dev'
+Requires-Dist: basedpyright<2.0.0,>=1.39.0; extra == 'dev'
+Requires-Dist: msgpack<2.0.0,>=1.1.0; extra == 'dev'
+Requires-Dist: openpyxl<4.0.0,>=3.1.0; extra == 'dev'
+Requires-Dist: pymupdf>=1.25.0; extra == 'dev'
+Requires-Dist: pypdf<6.0.0,>=5.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio<2.0.0,>=1.3.0; extra == 'dev'
+Requires-Dist: pytest-cov<7.0.0,>=6.0.0; extra == 'dev'
+Requires-Dist: pytest-xdist<4.0.0,>=3.8.0; extra == 'dev'
+Requires-Dist: pytest<10.0.0,>=9.0.0; extra == 'dev'
+Requires-Dist: python-docx<2.0.0,>=1.1.0; extra == 'dev'
+Requires-Dist: python-pptx<2.0.0,>=1.0.0; extra == 'dev'
+Requires-Dist: python-socketio<6.0.0,>=5.16.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: documents
+Requires-Dist: defusedxml<1.0.0,>=0.7.1; extra == 'documents'
+Requires-Dist: openpyxl<4.0.0,>=3.1.0; extra == 'documents'
+Requires-Dist: pypdf<6.0.0,>=5.0.0; extra == 'documents'
+Requires-Dist: python-docx<2.0.0,>=1.1.0; extra == 'documents'
+Requires-Dist: python-pptx<2.0.0,>=1.0.0; extra == 'documents'
+Provides-Extra: langfuse
+Requires-Dist: langfuse<4.0.0,>=3.0.0; extra == 'langfuse'
+Provides-Extra: olostep
+Requires-Dist: olostep>=0.1.0; (python_version < '3.14') and extra == 'olostep'
+Provides-Extra: pdf
+Requires-Dist: pypdf<6.0.0,>=5.0.0; extra == 'pdf'
+Description-Content-Type: text/markdown
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="./images/readme-cover-dark.svg">
+  <img alt="nanoinfra README cover" src="./images/readme-cover-light.svg">
+</picture>
+
+<div align="center">
+  <p>
+    <a href="https://nanoinfra.wiki/docs/latest/getting-started/nanoinfra-overview">English</a> |
+    <a href="https://nanoinfra.wiki/cn/docs/latest/getting-started/nanoinfra-overview">简体中文</a> |
+    <a href="https://nanoinfra.wiki/zh-Hant/docs/latest/getting-started/nanoinfra-overview">繁體中文</a> |
+    <a href="https://nanoinfra.wiki/es/docs/latest/getting-started/nanoinfra-overview">Español</a> |
+    <a href="https://nanoinfra.wiki/fr/docs/latest/getting-started/nanoinfra-overview">Français</a> |
+    <a href="https://nanoinfra.wiki/id/docs/latest/getting-started/nanoinfra-overview">Bahasa Indonesia</a> |
+    <a href="https://nanoinfra.wiki/ja/docs/latest/getting-started/nanoinfra-overview">日本語</a> |
+    <a href="https://nanoinfra.wiki/ko/docs/latest/getting-started/nanoinfra-overview">한국어</a> |
+    <a href="https://nanoinfra.wiki/ru/docs/latest/getting-started/nanoinfra-overview">Русский</a> |
+    <a href="https://nanoinfra.wiki/vi/docs/latest/getting-started/nanoinfra-overview">Tiếng Việt</a>
+  </p>
+  <p>
+    <a href="https://github.com/bet0x/nanoinfra"><img src="https://img.shields.io/github/stars/bet0x/nanoinfra?style=flat&logo=github" alt="GitHub stars"></a>
+    <a href="https://pypi.org/project/nanoinfra/"><img src="https://img.shields.io/pypi/v/nanoinfra" alt="PyPI version"></a>
+    <a href="https://pepy.tech/project/nanoinfra"><img src="https://static.pepy.tech/badge/nanoinfra" alt="PyPI downloads"></a>
+    <a href="https://github.com/bet0x/nanoinfra/actions/workflows/ci.yml"><img src="https://github.com/bet0x/nanoinfra/actions/workflows/ci.yml/badge.svg?branch=main" alt="Test Suite"></a>
+    <a href="https://pypi.org/project/nanoinfra/"><img src="https://img.shields.io/badge/python-%3E%3D3.11-blue" alt="Python 3.11 or newer"></a>
+    <a href="./LICENSE"><img src="https://img.shields.io/github/license/bet0x/nanoinfra" alt="MIT License"></a>
+    <a href="https://nanoinfra.wiki/docs/latest/getting-started/nanoinfra-overview"><img src="https://img.shields.io/badge/docs-nanoinfra.wiki-blue" alt="nanoinfra documentation"></a>
+  </p>
+  <p>
+    <a href="https://discord.gg/MnCvHqpUGB">Discord</a> ·
+    <a href="https://x.com/nanoinfra_project">X</a> ·
+    <a href="./COMMUNICATION.md">WeChat / Feishu</a>
+  </p>
+</div>
+
+# nanoinfra
+
+🐈 **nanoinfra** is an ultra-lightweight, open-source, self-hosted personal AI agent framework written in Python. It runs in a WebUI, terminal, or chat apps and combines tools, long-term memory, MCP integrations, model routing, multi-agent delegation, scheduled automation, and an OpenAI-compatible API in a small, readable core.
+
+## Start Here
+
+| You want to... | Go to |
+|---|---|
+| Install nanoinfra with no terminal/config background | [Start Without Technical Background](./docs/start-without-technical-background.md) |
+| Install quickly and get one CLI reply | [Install](#-install) and [Quick Start](#-quick-start) |
+| Open the bundled browser UI | [WebUI](#-webui) |
+| Connect Telegram, Discord, WeChat, Slack, Email, Mattermost, or another chat app | [Chat Apps](./docs/chat-apps.md) |
+| Configure providers, fallback models, Langfuse, MCP, web tools, or security | [Docs](./docs/README.md) and [Configuration](./docs/configuration.md) |
+| Understand or extend the internals | [Architecture](./docs/architecture.md) and [Development](./docs/development.md) |
+| Deploy to the cloud or keep nanoinfra running as a service | [Deployment](./docs/deployment.md) |
+
+## What can nanoinfra do?
+
+nanoinfra is a self-hosted personal AI agent runtime. It can:
+
+- run in a browser WebUI or terminal
+- connect to Telegram, Discord, Slack, WeChat, Email, Mattermost, and other chat apps
+- use tools such as files, shell, web search, web fetch, MCP, cron, image generation, and subagents
+- keep session history and long-term memory through Dream
+- run long-horizon goals and scheduled automations
+- expose a Python SDK and OpenAI-compatible API for integrations
+- deploy as a long-running local or server-side agent gateway
+
+## 💡 Why nanoinfra
+
+- **Persistent workflows**: goals, memory, tools, and chat context survive long-running work.
+- **Chat-native reach**: WebUI, API, Telegram, Feishu, Slack, Discord, Teams, email, and Mattermost.
+- **Model freedom**: OpenAI-compatible APIs, local LLMs, image generation, search, and fallbacks.
+- **Small core**: readable internals with MCP, memory, deployment, and automation built in.
+- **Own your stack**: inspect, customize, self-host, and extend without a giant platform.
+
+## 📦 Install
+
+> [!IMPORTANT]
+> If you want the newest features and experiments, install from source.
+>
+> If you want the most stable day-to-day experience, install from PyPI or with `uv`.
+
+Pick **one** install method:
+
+Prerequisites: Python 3.11 or newer. Git is only needed for a source install. Published packages already include the WebUI; a current-source install needs `bun` or `npm` to build it.
+
+If terminals, API keys, or config files are new to you, use the guided zero-background walkthrough in [Start Without Technical Background](./docs/start-without-technical-background.md) instead of this compact README path.
+
+**One-command setup**
+
+macOS / Linux:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/bet0x/nanoinfra/main/scripts/install.sh | sh
+```
+
+Windows PowerShell:
+
+```powershell
+irm https://raw.githubusercontent.com/bet0x/nanoinfra/main/scripts/install.ps1 | iex
+```
+
+The default command installs or upgrades `nanoinfra` from PyPI. On a fresh local desktop, it then starts `nanoinfra webui` so you can configure the first provider and model in **Settings → Models**. SSH, headless, existing-config, and older-release paths keep the terminal setup wizard. The installer avoids system-wide pip installs by using an active virtual environment, `uv`, `pipx`, or a managed venv under `~/.nanoinfra/venv`. It also prints the exact command it used to run nanoinfra; reuse that full command below if `nanoinfra` is not on `PATH`.
+
+To preview the plan without changing your environment, pass `--dry-run`; combine it with `--dev` when you want to preview the main-branch install.
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/bet0x/nanoinfra/main/scripts/install.sh | sh -s -- --dry-run
+```
+
+```powershell
+& ([scriptblock]::Create((irm https://raw.githubusercontent.com/bet0x/nanoinfra/main/scripts/install.ps1))) --dry-run
+```
+
+To install the current `main` branch instead, pass `--dev`:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/bet0x/nanoinfra/main/scripts/install.sh | sh -s -- --dev
+```
+
+```powershell
+& ([scriptblock]::Create((irm https://raw.githubusercontent.com/bet0x/nanoinfra/main/scripts/install.ps1))) --dev
+```
+
+If you prefer to inspect the script first, open [`scripts/install.sh`](./scripts/install.sh) or [`scripts/install.ps1`](./scripts/install.ps1).
+
+**Install with `uv`**
+
+```bash
+uv tool install nanoinfra
+```
+
+**Install from PyPI with pip**
+
+```bash
+python -m pip install nanoinfra
+```
+
+If pip reports `externally-managed-environment` on macOS or Linux, use the one-command installer, `uv tool install nanoinfra`, `pipx install nanoinfra`, or install inside a virtual environment.
+
+**Install from source**
+
+`bun` or `npm` must be available. From an activated virtual environment:
+
+```bash
+git clone https://github.com/bet0x/nanoinfra.git
+cd nanoinfra
+python -m pip install .
+```
+
+On Windows, if pip reports that it cannot launch `npm`, run `cd webui`, `npm.cmd install --package-lock=false`, `npm.cmd run build`, and `cd ..` in order, then retry the install. Contributors who need an editable checkout should follow [`CONTRIBUTING.md`](./CONTRIBUTING.md) and [`webui/README.md`](./webui/README.md).
+
+Verify the install:
+
+```bash
+nanoinfra --version
+```
+
+If `nanoinfra` is not on `PATH`, invoke it through the method that installed it: reuse the recommended installer's command, use `uv tool run --from nanoinfra nanoinfra ...` or `pipx run --spec nanoinfra nanoinfra ...`, or use the Python executable from the environment where pip installed the package.
+
+## 🚀 Quick Start
+
+**Open nanoinfra in your browser**
+
+```bash
+nanoinfra webui
+```
+
+This is the recommended first run. The launcher creates the config and workspace when needed, safely enables the local WebSocket channel after confirmation, starts the gateway, and opens [`http://127.0.0.1:8765`](http://127.0.0.1:8765). A fresh install can open before a model is configured, so setup continues in the browser instead of beginning in a JSON file. The first-run WebUI binds to localhost by default and is not exposed to your LAN.
+
+**Your first three steps**
+
+1. Open **Settings → Models** and choose a provider, credential, and model.
+2. Start a new topic and send `Hello!` to verify the connection.
+3. Before project work, choose the intended workspace and access mode from the composer.
+
+Any normal reply means the provider, model, workspace, and browser gateway are working together.
+
+**Keep nanoinfra running after you close the terminal**
+
+```bash
+nanoinfra webui --background
+```
+
+This starts the same full gateway as `nanoinfra webui`, opens the browser, and leaves channels and automations running after the launcher exits. Complete first-time model setup with foreground `nanoinfra webui` before switching to background mode.
+
+```bash
+nanoinfra gateway status
+nanoinfra gateway logs
+nanoinfra gateway restart
+nanoinfra gateway stop
+```
+
+**Prefer a gateway-first workflow?**
+
+```bash
+nanoinfra gateway
+```
+
+This skips WebUI setup and browser opening, then runs the same complete gateway in the current terminal. It is the familiar entry point if you are coming from OpenClaw or already operate agents as long-lived services. The WebUI remains available when its channel is configured; open it manually when needed.
+
+Use `nanoinfra gateway --background` for the same direct entry point without keeping the terminal attached. For automatic startup and supervision by the operating system, see [Deployment](./docs/deployment.md).
+
+**Prefer to work entirely in the terminal?**
+
+```bash
+nanoinfra agent
+```
+
+This opens an interactive terminal chat with the same configured model, workspace, and tools while keeping its own CLI session history. It does not open a browser or keep chat channels and automations running after you exit. Type `exit` or press `Ctrl+C` when you are done.
+
+For one request and an immediate exit, use:
+
+```bash
+nanoinfra agent -m "Hello!"
+```
+
+The one-shot form is useful for a quick provider check, shell scripts, and local automation. If you have not configured a model yet, run `nanoinfra webui` and open **Settings → Models** first.
+
+Need manual JSON, another device on your LAN, or help with provider/model matching? Continue with [Install and Quick Start](./docs/quick-start.md), [WebUI](./docs/webui.md), or [Troubleshooting](./docs/troubleshooting.md).
+
+If nanoinfra worked for you, a star on GitHub is the simplest way to support the project.
+
+- Want a pasteable provider setup? See [Provider Cookbook](./docs/provider-cookbook.md)
+- Want to understand provider/model matching? See [Providers and Models](./docs/providers.md)
+- Want web search, MCP, security settings, or more config options? See [Configuration](./docs/configuration.md)
+- Want to run locally? See [Ollama](./docs/providers.md#ollama), [vLLM or another local OpenAI-compatible server](./docs/providers.md#vllm-or-other-local-openai-compatible-server), and the full [provider reference](./docs/configuration.md#providers).
+- Want to run nanoinfra in chat apps like Telegram, Discord, WeChat or Feishu? See [Chat Apps](./docs/chat-apps.md)
+- Want Docker or Linux service deployment? See [Deployment](./docs/deployment.md)
+
+<a id="deploy-to-render"></a>
+
+## ☁️ Deploy
+
+**Render — one click**
+
+Deploy nanoinfra's gateway and bundled WebUI from the repository's ready-to-use Blueprint:
+
+[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/bet0x/nanoinfra)
+
+Render will ask for `ANTHROPIC_API_KEY` and a private `NANOINFRA_WEB_TOKEN`, then provision persistent storage for sessions, memory, and WebUI history. Persistent disks require a paid Render service.
+
+**Self-host**
+
+Prefer your own infrastructure? Follow the [deployment guide](./docs/deployment.md) for Docker, Docker Compose, Linux services, and macOS LaunchAgent setup.
+
+## 🌐 WebUI
+
+The WebUI ships **inside the published wheel** with no separate frontend build. It is the browser workbench for persistent topics, visible agent activity, workspace controls, Apps, Skills, Automations, and settings.
+
+<p align="center">
+  <img src="images/nanoinfra_webui.png" alt="nanoinfra webui preview" width="900">
+</p>
+
+Use it to:
+
+- keep separate topics for different tasks and projects;
+- inspect reasoning, tool calls, file edits, diffs, command output, and generated artifacts;
+- switch models and workspaces without leaving the conversation;
+- configure providers, chat channels, Apps, Skills, and Automations from one place.
+
+See the [WebUI guide](./docs/webui.md) for LAN access, background operation, workspace controls, and the full feature tour. Working on the frontend itself? Use [`webui/README.md`](./webui/README.md).
+
+## 🏗️ Architecture
+
+<p align="center">
+  <img src="images/nanoinfra_arch.png" alt="nanoinfra architecture" width="800">
+</p>
+
+🐈 nanoinfra stays lightweight by centering everything around a small agent loop: messages come in from chat apps, the LLM decides when tools are needed, and memory or skills are pulled in only as context instead of becoming a heavy orchestration layer. That keeps the core path readable and easy to extend, while still letting you add channels, tools, memory, and deployment options without turning the system into a monolith.
+
+## 📚 Docs
+
+Browse the [repo docs](./docs/README.md) for the latest features and GitHub development version, or visit [nanoinfra.wiki](https://nanoinfra.wiki/docs/latest/getting-started/nanoinfra-overview) for the stable release documentation.
+
+- Use task-oriented guides: [Guides](./docs/guides/README.md)
+- Start with no technical background: [Start Without Technical Background](./docs/start-without-technical-background.md)
+- Start from zero with developer basics: [Install and Quick Start](./docs/quick-start.md)
+- Understand the runtime model: [Concepts](./docs/concepts.md)
+- Read the source-level map: [Architecture](./docs/architecture.md)
+- Choose a provider/model: [Providers and Models](./docs/providers.md)
+- Copy provider setup recipes: [Provider Cookbook](./docs/provider-cookbook.md)
+- Debug setup and runtime failures: [Troubleshooting](./docs/troubleshooting.md)
+- Talk to your nanoinfra with familiar chat apps: [Chat App AI Agent](./docs/guides/chat-app-ai-agent.md) · [Chat Apps](./docs/chat-apps.md)
+- Schedule or trigger agent work: [Automations](./docs/automations.md)
+- Configure providers, web search, MCP, and runtime behavior: [Configuration](./docs/configuration.md)
+- Integrate nanoinfra with local tools and automations: [OpenAI-Compatible API](./docs/openai-api.md) · [Python SDK](./docs/python-sdk.md)
+- Run nanoinfra with Docker or as a Linux service: [Deployment](./docs/deployment.md)
+
+## Releases
+
+**Latest release: [v0.3.0 - The Agency Release](https://github.com/HKUDS/nanobot/releases/tag/v0.3.0)**
+
+The Agency Release turns nanoinfra from a durable workbench into an agent runtime that can coordinate helpers, switch models per session, and carry authorized work through to completion.
+
+- Consult inline subagents without leaving the current task
+- Switch model presets per session directly from the composer
+- Start from a guided WebUI setup with clearer execution controls
+- Apply configuration changes live across a more reliable provider, channel, and tool runtime
+
+[Read the v0.3.0 release notes](https://github.com/HKUDS/nanobot/releases/tag/v0.3.0)
+
+## Recent Updates
+
+- **2026-07-24** Guided first-run setup, inline subagents, and model switching from the composer.
+- **2026-07-23** Grok OAuth with hosted X Search, live image settings, and clearer fallback models.
+- **2026-07-22** Parallel Search, live configuration reloads, richer app discovery, and a smoother mobile WebUI.
+- **2026-07-21** Codex fast mode, visible skill references, safer configuration saves, and sturdier task cleanup.
+- **2026-07-20** Cleaner code blocks and copy actions, self-contained channels, and steadier QQ reconnects.
+
+For older updates, see the [release archive](./docs/release-archive.md) or [GitHub releases](https://github.com/bet0x/nanoinfra/releases).
+
+## Open Source Partners
+
+<p align="center">
+  <a href="https://platform.kimi.com?aff=nanoinfra"><picture><source media="(prefers-color-scheme: dark)" srcset="https://kimi-file.moonshot.cn/prod-chat-kimi/kfs/4/1/2026-06-05/1d8h69mt3v89kkekg24gg"><img alt="Kimi Open Source Friends" height="44" src="https://kimi-file.moonshot.cn/prod-chat-kimi/kfs/4/1/2026-06-05/1d8h69fudcmosb3pipls0"></picture></a>
+  <a href="https://platform.minimaxi.com/subscribe/token-plan?code=GILTJpMTqZ&source=link"><img alt="MiniMax" height="40" src="https://mintcdn.com/minimax-zh/1UjvBcdoC6r0UeyA/logo/light.svg?fit=max&auto=format&n=1UjvBcdoC6r0UeyA&q=85&s=672d724b639b2d88d0702fae329ea4f8"></a>
+</p>
+
+## 🤝 Contribute
+
+Use nanoinfra for a real task, report what broke, and then pick a focused improvement.
+
+- Read [CONTRIBUTING.md](./CONTRIBUTING.md) for the development workflow.
+- Browse [open issues](https://github.com/bet0x/nanoinfra/issues) for problems to investigate.
+- Open a [pull request](https://github.com/bet0x/nanoinfra/pulls) for a focused fix or integration.
+
+## Contact
+
+Nanoinfra is a fork of [nanobot](https://github.com/re-bin/nanobot), the original open-source project started by [Xubin Ren](https://github.com/re-bin). This fork is maintained by Alberto Ferrer. Feel free to contact [albertof@barrahome.org](mailto:albertof@barrahome.org) for questions, ideas, or collaboration.
+
+### Contributors
+
+<a href="https://github.com/bet0x/nanoinfra/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=bet0x/nanoinfra&max=100&columns=12&updated=20260210" alt="Contributors" />
+</a>
+
+<p align="center">
+  <em> Thanks for visiting ✨ nanoinfra!</em><br><br>
+  <img src="https://visitor-badge.laobi.icu/badge?page_id=HKUDS.nanoinfra&style=for-the-badge&color=00d4ff" alt="Views">
+</p>