Metadata-Version: 2.4
Name: alysis-code
Version: 0.16.3
Summary: Open-source AI coding agent for your terminal. Bring any model, sandboxed by default.
Project-URL: Homepage, https://alysiscode.com/
Project-URL: Documentation, https://alysiscode.com/docs
Project-URL: Changelog, https://github.com/AlysisAi/AlysisCode/blob/main/docs/CHANGELOG.md
Project-URL: Funding, https://github.com/sponsors/AlysisAi
Project-URL: Issues, https://github.com/AlysisAi/AlysisCode/issues
Project-URL: Security, https://github.com/AlysisAi/AlysisCode/blob/main/.github/SECURITY.md
Project-URL: Source, https://github.com/AlysisAi/AlysisCode
License: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: agent,ai,ai-agent,ai-coding-agent,cli,coding-agent,developer-tools,llm,local-llm,mcp,ollama,sandbox,terminal,tui
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: anyio>=4.14.2
Requires-Dist: brotli>=1.2.1; platform_python_implementation == 'CPython'
Requires-Dist: brotlicffi>=1.2.1.0; platform_python_implementation != 'CPython'
Requires-Dist: certifi>=2026.10.19
Requires-Dist: click>=8.0.0
Requires-Dist: cryptography>=50.0.0
Requires-Dist: ddgs>=9.0.0
Requires-Dist: dulwich==1.2.19; sys_platform == 'win32'
Requires-Dist: httpcore<2.0.0,>=1.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: jsonschema>=4.23.0
Requires-Dist: keyring>=25.0.0
Requires-Dist: markdown-it-py<5.0.0,>=4.2.0
Requires-Dist: packaging>=23.0
Requires-Dist: pillow>=13.0.0
Requires-Dist: platformdirs>=4.2.0
Requires-Dist: prompt-toolkit>=3.0.43
Requires-Dist: psutil<8.0,>=7.2.2
Requires-Dist: pydantic>=2.6.0
Requires-Dist: pygments<3.0.0,>=2.17.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: rich>=13.7.1
Requires-Dist: tiktoken>=0.7.0
Requires-Dist: typer>=0.12.0
Requires-Dist: websockets<17.0,>=15.0
Provides-Extra: dev
Requires-Dist: dulwich==1.2.19; extra == 'dev'
Requires-Dist: editables==0.5; extra == 'dev'
Requires-Dist: hatchling==1.31.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: pyyaml>=6.0.0; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Provides-Extra: documents
Requires-Dist: lxml==6.1.3; extra == 'documents'
Requires-Dist: markdown-it-py==4.2.0; extra == 'documents'
Requires-Dist: openpyxl==3.1.5; extra == 'documents'
Requires-Dist: pypdfium2==5.13.0; extra == 'documents'
Requires-Dist: python-docx==1.2.0; extra == 'documents'
Requires-Dist: python-pptx==1.0.2; extra == 'documents'
Requires-Dist: reportlab==4.4.9; extra == 'documents'
Requires-Dist: xlsxwriter==3.2.9; extra == 'documents'
Provides-Extra: managed-build
Requires-Dist: pyinstaller-hooks-contrib==2026.6; extra == 'managed-build'
Requires-Dist: pyinstaller==6.21.0; extra == 'managed-build'
Requires-Dist: setuptools>=84.1.0; extra == 'managed-build'
Provides-Extra: server
Requires-Dist: fastapi>=0.115; extra == 'server'
Requires-Dist: python-multipart>=0.0.9; extra == 'server'
Requires-Dist: uvicorn[standard]>=0.30; extra == 'server'
Description-Content-Type: text/markdown

<p align="center">
  <a href="https://alysiscode.com">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="docs/assets/banner-dark.svg">
      <img src="docs/assets/banner.svg" alt="Alysis Code" width="560">
    </picture>
  </a>
</p>

<p align="center">The open-source AI agent for your terminal and desktop. Built from scratch, with free web search and computer use built in.</p>

<p align="center">
  <a href="https://pypi.org/project/alysis-code/"><img alt="PyPI" src="https://img.shields.io/pypi/v/alysis-code?style=flat-square"></a>
  <a href="https://github.com/AlysisAi/AlysisCode/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/AlysisAi/AlysisCode/ci.yml?style=flat-square&label=ci"></a>
  <a href="LICENSE"><img alt="License" src="https://img.shields.io/pypi/l/alysis-code?style=flat-square"></a>
  <a href="https://github.com/AlysisAi/AlysisCode"><img alt="Stars" src="https://img.shields.io/github/stars/AlysisAi/AlysisCode?style=flat-square"></a>
  <a href="https://discord.gg/psEVWZgzFS"><img alt="Discord members" src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscord.com%2Fapi%2Fv10%2Finvites%2FpsEVWZgzFS%3Fwith_counts%3Dtrue&amp;query=%24.approximate_member_count&amp;label=discord&amp;suffix=%20members&amp;style=flat-square&amp;logo=discord&amp;logoColor=white&amp;color=5865F2"></a>
</p>

<p align="center">
  <a href="https://alysiscode.com">Website</a> ·
  <a href="https://alysiscode.com/docs">Docs</a> ·
  <a href="https://alysiscode.com/#desktop-download">Download</a> ·
  <a href="docs/CHANGELOG.md">Changelog</a> ·
  <a href="https://discord.gg/psEVWZgzFS">Discord</a> ·
  <a href="https://x.com/alysiscode">X</a>
</p>

<p align="center">
  <img src="docs/assets/demo.gif" alt="Alysis Code CLI welcome screen followed by a short conversation" width="900">
</p>

---

### Installation

```bash
# macOS, Linux and WSL
curl -LsSf https://raw.githubusercontent.com/AlysisAi/AlysisCode/main/scripts/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/AlysisAi/AlysisCode/main/scripts/install.ps1 | iex

# Package managers (Python 3.11+)
uv tool install alysis-code
pipx install alysis-code
```

The installers set up [uv](https://docs.astral.sh/uv/) and their own Python, so you don't need Python or admin rights. Run `alysis update` to upgrade. Both `alysis` and `alysis-code` start the CLI.

### Desktop App

Alysis Code is also a desktop app for macOS and Windows. It ships with its own copy of the engine in this repo, so there is no Python or CLI to install.

<table align="center">
  <tr>
    <td><a href="https://alysiscode.com/docs/desktop"><img src="https://alysiscode.com/images/home/app-code.png" alt="Alysis Code desktop app, Code view" width="800"></a></td>
  </tr>
</table>

- **Work** for documents: attach notes or a CSV and get back a Word file, spreadsheet, presentation or PDF. Results are versioned, and you can mark part of a preview and ask for a change.
- **Code** for repositories: chat about the code, read the diff in **Changes**, run commands in the built-in **Terminal**, and roll back to a checkpoint.
- **Projects** keep chats, folders and saved instructions together. You can import projects and history from other coding agents.
- **Browser** opens pages next to the chat, and an optional Chrome extension lets Alysis work in your own tabs.
- **Scheduled** runs recurring tasks (daily, weekdays, weekly or hourly) while the app is open.
- **Customize** adds skills, plugins, MCP servers and hooks. **Forge** plans larger coding changes as reviewed tasks.

| Platform | Installer | Architecture |
| --- | --- | --- |
| macOS | `.dmg` | Apple silicon (M-series) |
| Windows | `.exe` | 64-bit (x64) |

Get the installer for your computer from the **[download section on alysiscode.com](https://alysiscode.com/#desktop-download)**. The app checks for updates when it starts and while it runs; choose **Restart to update** when one is ready. There is no Linux build yet; use the CLI there.

[Desktop docs](https://alysiscode.com/docs/desktop) · [Install and update](https://alysiscode.com/docs/desktop/installation) · [Your first task](https://alysiscode.com/docs/desktop/first-task)

### Getting started

```bash
cd your-project
alysis
```

The first run walks you through connecting a model, picking a workspace and checking the sandbox. Run `alysis setup` to go through it again.

<details>
<summary>Choosing a model</summary>
<br>

**Your own key or a local model.** No Alysis account needed. Pick a provider in setup (OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter, xAI and others), or point it at any OpenAI-compatible endpoint such as Ollama, LM Studio or vLLM. A supported AI subscription works too. You pay your provider directly, or nothing for a local model.

**An Alysis account.** Run `alysis login` and approve the code in your browser. Every account gets 50 free credits every 30 days, no card required. See [pricing](https://alysiscode.com/pricing) for paid plans.

In the desktop app, both paths live under **Models & keys** in the account menu.

</details>

### What makes it different

- **Built from scratch.** Not a fork. Our own engine, tools and desktop app.
- **Free web search.** Works with any model, no API key needed.
- **Computer use.** Our own, built in. The agent can operate apps you allow.
- **Sandboxed by default.** Shell commands run in a sandbox enforced outside the model: Seatbelt on macOS, Bubblewrap or Docker on Linux and WSL, a native sandbox on Windows x64. Check yours with `alysis sandbox doctor --smoke`. [Sandbox modes](https://alysiscode.com/docs/safety/sandbox-modes)
  Verification commands also default to strict sandboxing. Strict mode refuses execution when no backend is available. [Shell sandbox](docs/shell_sandbox.md)
- **Any model.** Switch providers per task, mix in local models, or route roles to different models. [Models and providers](https://alysiscode.com/docs/config/models)
- **Permissions you choose.** `readonly`, `review`, `auto` or `fullaccess`, switched with **Shift+Tab**. A persona (`code`, `architect`, `ask`, `debug`) can narrow what the agent does but never widen it. [Permissions](https://alysiscode.com/docs/safety/approval-prompts) · [Personas](https://alysiscode.com/docs/concepts/personas)
- **Forge.** Turns a goal into a reviewed plan of dependent tasks, each with its own checks, so you get verified changes instead of one long chat. It uses a lot of tokens, so start small. [Forge guide](docs/forge.md)
- **Not only code.** Optional document tools for PDFs, Word, spreadsheets and slides. [Work guides](https://alysiscode.com/docs/guides)

### Documentation

Everything else, from config and MCP to server mode, is at [alysiscode.com/docs](https://alysiscode.com/docs). The same docs are in [docs/](docs/README.md). Editor integrations for [VS Code](extensions/vscode-alysis/README.md) and [JetBrains](extensions/jetbrains-alysis/README.md) (preview) live in `extensions/`.

### Contributing

Read the [contributing guide](.github/CONTRIBUTING.md) before opening a pull request. Report security issues privately through the [security policy](.github/SECURITY.md), not public issues.

### License

Apache-2.0. You can use, modify and distribute the code, including commercially, as long as you keep the attribution and license notices. See [LICENSE](LICENSE) and [NOTICE](NOTICE). The shared editor sidebar includes MIT-licensed adaptations from Kilo Code and OpenCode; keep its [third-party notices](extensions/shared-ui/THIRD_PARTY_NOTICES.txt).

---

**Join the community** [Discord](https://discord.gg/psEVWZgzFS) | [X](https://x.com/alysiscode) | [LinkedIn](https://www.linkedin.com/company/alysisai/) | [GitHub Issues](https://github.com/AlysisAi/AlysisCode/issues)
