Skip to content

README.md

Latest commit

 

History

History
207 lines (136 loc) · 7.19 KB

README.md

File metadata and controls

207 lines (136 loc) · 7.19 KB
Eneo Logo

Eneo

Democratic AI Platform for the Public Sector

License: AGPL v3 Made for: Public Sector Contributions Welcome Contributors

🌐 Website • Getting Started • Features • Documentation • Contributing

🏛️ What is Eneo?

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."

Why Choose Eneo?

  • 🔒 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

✨ Key Features

  • 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

🚀 Getting Started

For Production Deployment

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 -d

Note: The provided Docker Compose configuration is a reference example. Customize it for your organization's security, networking, and infrastructure requirements.

📖 Full Production Guide →

For Developers

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

📖 Development Setup Guide →

🖼️ Platform Preview

Eneo Personal Assistant Interface

Personal AI Assistant Interface

Eneo Collaborative Spaces

Team Collaboration Spaces

🏗️ Architecture

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
View Architecture Diagram Eneo Architecture

📚 Documentation

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

🤝 Contributing

We welcome contributions from municipalities, organizations, and developers who share our vision of democratic AI.

Quick Start

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

See our Contributing Guide for detailed guidelines.

🏛️ Community & Governance

Democratic Control

Eneo is governed by a user association of public sector organizations, ensuring development priorities align with public interest rather than commercial goals.

Get Involved

🙏 Acknowledgments

Developed by: Sundsvall Municipality & Ånge Municipality, Sweden 🇸🇪

Inspired by: Open ePlatform - Successfully used by 200+ Swedish municipalities since 2010

Special Thanks: InooLabs AB (now Intric AB) for foundational contributions

📜 License

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

See LICENSE for full license text.

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.

🚀 Development Branch

This branch contains the latest development features and CI/CD enhancements. Used for testing new features before merging to production.