wizards 0.1.9

package/LICENSE

@@ -0,0 +1,110 @@
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2026 - Matthias Platzer
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+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.

package/README.md

@@ -0,0 +1,170 @@
+<p align="center">
+  <img src="docs/assets/engenty.svg" width="96" alt="">
+</p>
+
+<h1 align="center">engenty wizards</h1>
+
+<p align="center">
+  Make a wish. Get your wizard.<br>
+  It guides you step by step.<br>
+  Let AI do the work.
+</p>
+
+<p align="center">
+  <img src="docs/assets/setup.png" alt="The first start of engenty wizards: choose the engine it thinks with — Codex, Claude Code, Gemini CLI, Cursor Agent or your own keys">
+</p>
+
+## What it does
+
+- **Describe it, get a wizard.** Say in plain words what you do again and again — a post with
+  an image, a research briefing, an invoice, a quote, a damage report — and engenty builds a
+  wizard for it: pages that ask what it needs, AI steps that do the work.
+- **AI steps do the work.** They research the web, write, draw images, render video, read PDFs,
+  scans and mails, build documents and dashboards, and write into other services over MCP, HTTP
+  or a browser. Anything that changes an account asks first.
+- **Share it with a link.** Anyone can run a wizard in the browser, on a phone too: camera,
+  code scan, voice notes, location and a drawn signature included. Results download as PDF,
+  Word, HTML, Markdown, PNG, MP4, CSV, Excel or JSON, or go out as a link.
+- **Runs on your machine, on your subscription.** It thinks with Codex, Claude Code, Gemini CLI
+  or Cursor Agent when one is installed and signed in, so no API key is needed. Or bring a key
+  (Vercel AI Gateway, OpenAI, Anthropic), or a local model through Ollama. Your wizards and
+  results stay in a folder on your machine.
+
+## Install
+
+On macOS or Linux, in a terminal:
+
+```bash
+curl -fsSL https://engenty.ai/install.sh | bash
+```
+
+It needs nothing but `curl` and asks for no password. It brings its own Node.js (a Node you
+already have is left alone), installs engenty wizards into `~/.engenty/wizards` and then walks
+you through the rest:
+
+- **Something to think with.** It looks for Codex, Claude Code, Gemini CLI and Cursor Agent and
+  offers to install one if there is none — first the one whose app (Claude, ChatGPT, Cursor) is
+  on your Mac, as its subscription is most likely yours already. The first page of the studio
+  installs them too. Or use an API key or [Ollama](https://ollama.com).
+- **Google Chrome and ffmpeg** (optional): Chrome for PDF and PNG exports and for steps that use
+  a browser, ffmpeg for MP4 videos of animated widgets.
+- **Start at login** (optional): engenty wizards starts in the background when you log in (a
+  LaunchAgent on a Mac, a systemd user service on Linux). Links and AI clients then always
+  reach it. `wizards autostart on` or `off` switches it later.
+
+Then it starts and the studio opens in your browser. Later, start it with:
+
+```bash
+wizards
+```
+
+It runs while that terminal is open; Ctrl-C stops it. `wizards status` says what is
+installed and what runs, `wizards setup` runs the guided setup again, and
+`wizards --help` lists the rest.
+
+**Install it as an app.** In Chrome or Edge the studio installs as an app: its own window, its
+own icon in the Dock or taskbar. The studio offers it in a banner at the top; or click the install
+icon at the right of the address bar.
+
+### From source
+
+You need Node.js 24.11 or newer and pnpm 10 (`corepack enable`).
+
+```bash
+git clone https://github.com/engenty/engenty-wizards.git
+cd engenty-wizards
+pnpm install
+pnpm build
+pnpm wizards
+```
+
+pnpm may list "Ignored build scripts" — that's expected, nothing to do.
+
+Code steps (shell, Node, Python) run in a sandbox when Docker and the sandbox image are on the
+machine; a checkout brings its own sandbox, the installed version has none yet.
+
+## First start
+
+The setup asks what engenty should think with. Pick an AI client that is installed on your
+computer — engenty uses your existing subscription and signs it in for you in a terminal right
+on the page — or enter your own keys. It stays until a test call works, then the studio opens.
+
+Change it later under Settings.
+
+## Using it
+
+- **Make a wizard:** describe it in the studio's chat, or start from one of the starters.
+  You see the steps as a diagram and can change any of them.
+- **Run and share:** try it yourself, then share the link. Shared results are kept for 7 days
+  for people without an account.
+- **Connect services:** Gmail, Google Drive, Calendar, Contacts, Outlook, OneDrive, Slack,
+  GitHub, HubSpot and S3 are built in; any other service can be added from its API description
+  or MCP server through the [integrations.sh](https://integrations.sh) registry. Services that
+  sign in with OAuth need a few settings first: [Connectors](docs/development.md#connectors).
+- **Build from Claude Code or Codex:** Settings → "Build with Claude Code & co." creates a key
+  and shows the command to add engenty wizards to your AI client.
+
+Your machine only answers on `localhost`. To let others open shared wizards, run it on a server.
+
+## Your data
+
+Everything lives in `~/.engenty/wizards/data`: the databases and the files of your wizards and
+results. Keys you enter are kept in the Keychain on a Mac, elsewhere encrypted in that folder.
+Back up the folder; delete it to start over. Settings go into `~/.engenty/wizards/.env` (see [.env.example](.env.example));
+`ENGENTY_HOME` moves the whole install.
+
+`pnpm start` in a checkout keeps its data in the `data` folder next to the code instead.
+
+## Update
+
+```bash
+wizards update
+```
+
+This runs the installer again without its questions. The studio says when a newer release is
+out and can run the same update from its footer.
+From source: `git pull`, `pnpm install`, `pnpm build`. Your data is brought up to date at the
+next start.
+
+To remove engenty wizards, run `wizards autostart off`, then delete `~/.engenty/wizards` (your data is in its `data` folder) and
+`~/.local/bin/wizards`.
+
+## Run it on a server
+
+With Docker, behind an https proxy (Caddy, Traefik, Coolify):
+
+```bash
+git clone https://github.com/engenty/engenty-wizards.git
+cd engenty-wizards
+cp .env.example .env    # set APP_URL to your https address and add a model key
+docker compose up -d --build
+docker compose logs     # shows the link to open once
+```
+
+Point the proxy at port 8891. On a server, engenty thinks with your keys or Ollama; the
+AI clients' subscriptions live on your own computer. The code sandbox is off in this image.
+
+## Troubleshooting
+
+| | |
+|---|---|
+| "This link is no longer valid" | The link works once. `wizards open` gives this browser a new one. |
+| `wizards`: command not found | Open a new terminal, or run `~/.local/bin/wizards`. |
+| You open it under another address | Set `APP_URL` in `~/.engenty/wizards/.env` to the address you open. |
+| An AI client shows as not signed in | Sign it in on the setup page, or in your own terminal (e.g. `claude`, `codex login`), then "Check again". |
+| PDF or PNG export fails | Install Google Chrome, or set `CHROME_PATH` to Chrome or Chromium. |
+| Port 24368 is taken | The next free port is used. To fix one, set `API_PORT` in `~/.engenty/wizards/.env`. |
+| Something else | `wizards doctor` checks the install. |
+
+More settings: [.env.example](.env.example).
+
+## For developers
+
+Development server, checks, how it is built, the managed mode:
+[docs/development.md](docs/development.md).
+
+## License
+
+[FSL-1.1-MIT](LICENSE): use it for yourself and your company, run it, change it — just don't
+offer it to others as a competing product or service. Each release becomes MIT two years
+after it is published.