Democratic AI Platform for the Public Sector
π Website β’ Getting Started β’ Features β’ Documentation β’ Contributing
Eneo is an open-source AI platform designed for Swedish public sector organizations to deploy and manage AI assistants while maintaining complete control over data, security, and algorithms.
Originally developed by Sundsvall Municipality and Γ nge Municipality, Eneo embodies the principle that "Generative AI must not be a technology for the few, but a technology for everyone."
- π Data Sovereignty - Your data never leaves your environment
- π€ Model Agnostic - Use OpenAI, Anthropic, Azure, or local models
- ποΈ Public Sector Focus - Built for municipal and government needs
- π Compliance Ready - GDPR and EU AI Act support built-in
- π True Open Source - AGPL v3 licensed with no vendor lock-in
- AI Assistant Management - Create and customize assistants for specific organizational needs
- Collaborative Spaces - Team workspaces with role-based access control
- Knowledge Management - Process documents, crawl websites with optional HTTP auth, semantic search
- Real-time Chat - Streaming responses with background task processing and token tracking
- Multi-language - Swedish and English interface with seamless switching
- Multi-Tenant Federation - Per-tenant identity providers with encrypted configuration
- Tenant-Specific Credentials - Isolated LLM API keys per organization with Fernet encryption
- API First - Full API documentation, type-safe integration, and runtime observability
Deploy Eneo in your organization with Docker Compose:
# Clone and navigate to deployment files
git clone https://github.com/eneo-ai/eneo.git
cd eneo/docs/deployment/
# Configure and deploy
cp env_backend.template env_backend.env
cp env_frontend.template env_frontend.env
# ... configure your environment ...
docker compose up -dNote: The provided Docker Compose configuration is a reference example. Customize it for your organization's security, networking, and infrastructure requirements.
π Full Production Guide β
SvelteKit in frontend/apps/web is the primary frontend and the default for
frontend development. React/Vite with Astryx in frontend/apps/web-next
is an optional beta. Implement ordinary frontend fixes and new features in
Svelte; work in web-next must be explicitly intended for the beta.
See the frontend development policy and
frontend setup.
Set up your development environment with VS Code DevContainer:
git clone https://github.com/eneo-ai/eneo.git
cd eneo && code .
# Click "Reopen in Container" when prompted- Platform: http://localhost:3000
- API Docs: http://localhost:8123/docs
- Default Login:
user@example.com/ChangeMePassword1!
π Development Setup Guide β
Modern microservices architecture with clean separation of concerns:
- Frontend: SvelteKit, TypeScript, Tailwind CSS
- Backend: FastAPI (Python 3.11+), SQLAlchemy
- Database: PostgreSQL with pgvector
- Cache/Queue: Redis with ARQ workers
- Deployment: Docker Compose with Traefik
| Guide | Description |
|---|---|
| Installation | Development environment setup |
| Deployment | Production deployment with Docker Compose |
| Architecture | Technical architecture and design patterns |
| Multi-Tenant Setup | Per-tenant identity provider configuration |
| AI Providers | Provider configuration & credential management |
| Contributing | Contribution guidelines |
| Security | Security practices and compliance |
| Troubleshooting | Common issues and solutions |
We welcome contributions from municipalities, organizations, and developers who share our vision of democratic AI. You do not need to belong to a team or an organization to contribute.
- Open or find an issue and agree on the change with the maintainers
- Fork the repository and branch from
develop - Make and test your change
- Open a pull request into
developthat links the issue - A Core Maintainer reviews it and merges it through the merge queue
See Contributing to Eneo for every way to contribute, and the Contributing Guide for development setup and standards. Report security vulnerabilities privately as described in SECURITY.md.
Eneo is governed by a user association of public sector organizations, ensuring development priorities align with public interest rather than commercial goals.
- Public Sector Organizations: Contact
digitalisering@sundsvall.sefor collaboration - Developers: Join our GitHub Discussions
- Bug Reports: Submit via GitHub Issues
- Website: https://eneo.ai/
- Forum: https://forum.eneo.ai/ (requires government or municipality email)
- Chat: https://chat.eneo.ai/ (requires government or municipality email)
Developed by: Sundsvall Municipality & Γ nge Municipality, Sweden πΈπͺ
Inspired by: Open ePlatform - Successfully used by 200+ Swedish municipalities since 2010
Special Thanks: InooLabs AB for foundational contributions
Eneo - Democratic AI Platform for the Public Sector
Copyright (C) 2023-2025 Sundsvall Municipality & Γ
nge Municipality
Licensed under GNU Affero General Public License v3.0
The repository-root LICENSE is the source of truth for Eneo's own code, including files without a license header.
Incorporated third-party code and dependencies retain their own licenses and attribution notices, documented with the corresponding code or dependency.
Made with β€οΈ by the Swedish Public Sector for the Global Community
Empowering democratic access to AI technology
π Website β’ π«±π»βπ«²π½ Forum β’ π¬ Chat β’ π§ Contact β’ π¬ Discussions β’ π Issues
Forum and Chat require a government or municipality email.
This branch contains the latest development features and CI/CD enhancements. Used for testing new features before merging to production.


