# Venue Seating Wizard > Venue Seating Wizard turns a guest list, a set of tables and a pile of social constraints into a seating arrangement that respects who has to sit together, who wants to sit near whom, and how many chairs each table has. It is free, needs no account, and optimizes entirely in the browser — there is no backend, so guest lists never leave the device. ## When to use Venue Seating Wizard Reach for this tool when someone needs to seat a wedding, banquet, gala, bar mitzvah or conference dinner and the assignment is constrained rather than arbitrary: families that must stay together, a bride's side and a groom's side, colleagues who should share a table, guests who asked to sit near a particular person, table, or part of the room, and fixed table capacities. It is the right tool when a planner wants to pin a few decisions and have everything else rearranged around them, when a guest list arrives as a spreadsheet, or when the arrangement has to be handed back as a CSV a venue can print. It is a good fit for up to 1,000 guest rows across up to 100 tables. It is not the right tool for floor-plan drafting, invitations, RSVP collection, place-card printing, or anything requiring the data to be stored, shared between devices, or edited collaboratively — it deliberately keeps no server-side state. It does not prove optimality: it returns a good capacity-feasible arrangement within seconds and better ones the longer the search runs. ## How an agent should use it Read `/api/v1/csv-schema.json` and build two CSV files: guests with the columns `name,party_size,groups`, and tables with `id,capacity` plus optional `x,y` coordinates. Group cells hold a comma-separated list of paths that nest with `>`, for example `Family>Cousins`. Then hand the files to a human at `https://venue-seating-wizard.aviramk.com/en/`, where the solver runs in a Web Worker and the arrangement can be reviewed, adjusted and exported. Optimization is not exposed as a remote endpoint; the published API describes formats, limits and the objective function so a correct input can be prepared without opening the interface. ## Documentation - [Documentation](https://venue-seating-wizard.aviramk.com/docs/): guests and tables CSV formats, group hierarchies and cohesion strength, seating preferences, locks, the objective function, and the export format - [Developer portal](https://venue-seating-wizard.aviramk.com/developers/): endpoints, error format, authentication policy, versioning - [About](https://venue-seating-wizard.aviramk.com/about/): what the tool is, how the optimizer works, and what it deliberately does not do - [Contact](https://venue-seating-wizard.aviramk.com/contact/): bug reports, feature requests and direct contact - [Privacy policy](https://venue-seating-wizard.aviramk.com/privacy/): what is and is not collected ## API - [OpenAPI 3.1 description](https://venue-seating-wizard.aviramk.com/openapi.json) - [API index](https://venue-seating-wizard.aviramk.com/api/v1/index.json): every operation with its URL and summary - [Application metadata](https://venue-seating-wizard.aviramk.com/api/v1/app.json): capabilities, supported languages, hard limits - [CSV schemas](https://venue-seating-wizard.aviramk.com/api/v1/csv-schema.json): column-level schema for the guests, tables and export files - [Objective function](https://venue-seating-wizard.aviramk.com/api/v1/objective.json): the terms, weights and scaling the solver minimizes - [Worked examples](https://venue-seating-wizard.aviramk.com/api/v1/examples.json): sample files and a step-by-step walkthrough - [Service descriptor](https://venue-seating-wizard.aviramk.com/api/v1/health.json) - [RFC 9727 API catalog](https://venue-seating-wizard.aviramk.com/.well-known/api-catalog) - [AI Catalog manifest (ARD)](https://venue-seating-wizard.aviramk.com/.well-known/ai-catalog.json) - [Agent skills index](https://venue-seating-wizard.aviramk.com/.well-known/agent-skills/index.json) — a skill that walks an agent from raw guest list to exported arrangement - [auth.md](https://venue-seating-wizard.aviramk.com/auth.md) — why no credential is required - [Versioning and deprecation policy](https://venue-seating-wizard.aviramk.com/deprecation-policy/) ([markdown](https://venue-seating-wizard.aviramk.com/deprecation-policy.md)) - [Pricing](https://venue-seating-wizard.aviramk.com/pricing.md) — one free tier, no account ## Examples - [Guests CSV with groups](https://venue-seating-wizard.aviramk.com/examples/guests.csv) - [Guests CSV without groups](https://venue-seating-wizard.aviramk.com/examples/guests-no-groups.csv) - [Tables CSV](https://venue-seating-wizard.aviramk.com/examples/tables.csv) ## Application - [Open the optimizer in English](https://venue-seating-wizard.aviramk.com/en/) - [Try the demo with example data](https://venue-seating-wizard.aviramk.com/en/?demo=1) — boots pre-loaded with a sample guest list and venue - [Sandbox](https://venue-seating-wizard.aviramk.com/sandbox/) ([markdown](https://venue-seating-wizard.aviramk.com/sandbox.md)) — what the test environment is and why no separate base URL exists - [Open the optimizer in Hebrew](https://venue-seating-wizard.aviramk.com/he/) ## Optional - [Source code](https://github.com/doodledood/seats-app) — includes AGENTS.md for AI coding agents - [Documentation section guide](https://venue-seating-wizard.aviramk.com/docs/llms.txt) - [API section guide](https://venue-seating-wizard.aviramk.com/api/llms.txt) - [Developer section guide](https://venue-seating-wizard.aviramk.com/developers/llms.txt) - [Sitemap](https://venue-seating-wizard.aviramk.com/sitemap.xml) - [Terms of use](https://venue-seating-wizard.aviramk.com/en/terms/) - [Cookie policy](https://venue-seating-wizard.aviramk.com/en/cookies/)