Anetos (Greek άνετος, "at ease, comfortable"; say AH-neh-tos).
Module anetos.dev/anetos, command anetos.
A new, batteries-included Go web framework: easy to start with, easy to
extend, and easy to run. It's built the Go way: typed, net/http-compatible,
code generation instead of runtime magic, and a supervised runtime where HTTP,
queue workers, pub/sub listeners and the scheduler run together in one
binary.
Status: early. v0.5.0 is the first public release: it installs with
go install, and the upgrade guides say what
changes between releases. APIs will still change before v1.
- v0.1, the foundation: the app, configuration, runtime
supervisor, HTTP layer, validation, data layer with relations,
migrations, model code generation, views, sessions, forms, the CLI and
testing helpers.
- v0.2, the batteries: the cache, server-side sessions and rate
limiting, authentication, social login, queues, events, pub/sub
listeners, the scheduler, mail, file storage, plugins (
anetos add),
test fakes, N+1 detection and anetos make:auth;
examples/saas runs them as one binary or split by
process type.
- v0.3, search, AI and the starter experience: full-text search and
search by meaning with hybrid ranking (PostgreSQL with pgvector,
MariaDB 11.7+ or SQLite); AI with Anthropic, OpenAI (and compatible
servers) and Gemini: typed calls, tools that run as the user, agents,
stored conversations, streaming, budgets and a test fake
(
examples/assistant); roles and permissions,
global and per team (examples/teams);
internationalization, with Bangla, French and Spanish translations of
the framework (examples/i18n); an audit log and
soft deletes (examples/audit); the admin (module
anetos.dev/anetos/admin, examples/admin) with
two-factor authentication; account settings; Google Cloud Storage; anetos build, a Dockerfile and a systemd unit
(Deploy); a starter theme,
make:crud and error pages in the app's layout; a security review
(checklist, SECURITY.md)
and a doctor command in every app; benchmarks
against plain net/http, chi, Gin and Echo, with CI holding every
change to allocation budgets.
- v0.4, the API stack:
anetos new --stack=api, an app that serves
JSON only; accounts that log in with API tokens, with two-factor
codes and abilities; make:crud JSON endpoints with pages, sorting
and filters; typed results with the route's status; an OpenAPI 3.1
description generated from the handlers, served and checked in a
test (examples/bookmarks).
- v0.5, the first public release: installs from the module proxy
with
go install; interface components in every web project
(views/ui) and a choice of CSS framework (Pico, Bootstrap, Bulma,
Tailwind CSS or none; css:use switches); one vocabulary across
settings, commands and the API, with a
glossary; projects ready for
coding agents (AGENTS.md, skills, the docs offline in the tool,
anetos check, the app describing itself as JSON, an MCP server,
llms.txt;
guide); a security
check of the app's code, dependencies, routes, settings and running
site
(security:check, with
reports for GitHub's code scanning;
guide);
contributor docs, governance and a code of conduct
(Contributing).
The tutorial builds an
issue tracker step by step, and examples/tracker,
the reference app, is a bigger one; the
API tutorial builds
examples/bookmarks, a JSON API. The docs are at
docs.anetos.dev.
Documents
Developer experience
go install anetos.dev/anetos/cli/cmd/anetos@latest # the anetos command (Go 1.26+)
anetos new blog && cd blog # templ views in a starter theme (light/dark), sessions, CSRF, SQLite
go tool anetos make:crud Post title:string body:text published:bool # pages to list, show, create, edit, delete
go tool anetos make:auth # accounts: password, Google, GitHub, API tokens
go tool anetos make:admin # an admin at /admin; make:admin-resource Post adds posts
go run . migrate
go tool anetos css:use pico # restyle the app's pages: Pico, Bootstrap, Bulma, Tailwind CSS or none
go tool anetos dev # rebuild and reload on every change
go tool anetos check # generate, build, vet, test, doctor, security: does it work?
go tool anetos docs queues # the docs at your Anetos version, offline
go tool anetos build # bin/blog: one static binary, everything in it
./bin/blog # everything: web, queue workers and the scheduler
./bin/blog run --only=web # or split by process type when you scale
./bin/blog run --only=worker
./bin/blog doctor # unsafe settings, pending migrations
./bin/blog help # migrate, route:list, your own commands, …
docker build -t blog . # or the image, from the generated Dockerfile
anetos new shop --stack=api # or JSON only: routes under /api/v1, errors as problem details,
# an OpenAPI 3.1 description (openapi.json) a test keeps current;
# there, make:auth writes accounts that log in with API tokens,
# and make:crud JSON endpoints (pages, sorting, filters)
Contributing
Issues, questions and pull requests are welcome. Read
CONTRIBUTING.md first; questions go to
Discussions, and
vulnerabilities privately, as SECURITY.md says.
GOVERNANCE.md says how decisions are made, and everyone
follows the
code of conduct.
License
Apache License 2.0. See LICENSE and NOTICE.
