base on Free IDE for Kubernetes # Freelens
<!-- markdownlint-disable MD013 -->
[](https://freelens.app)
[](https://github.com/freelensapp/freelens)
[](https://discord.gg/NjKZERK95Y)
[](https://www.reddit.com/r/freelens/)
[](https://deepwiki.com/freelensapp/freelens)
[](https://insights.linuxfoundation.org/project/freelens)
[](https://github.com/freelensapp/freelens?tab=MIT-1-ov-file#readme)
[](https://github.com/freelensapp/freelens/releases/latest)
[](https://formulae.brew.sh/cask/freelens#default)
[](https://winstall.app/apps/Freelensapp.Freelens)
[](https://scoop.sh/#/apps?q=freelens&s=1&d=0)
[](https://flathub.org/apps/app.freelens.Freelens)
[](https://snapcraft.io/freelens)
[](https://aur.archlinux.org/packages/freelens-bin)
[](https://www.npmjs.com/package/@freelensapp/core)
[](https://github.com/freelensapp/freelens/actions/workflows/unit-tests.yaml)
[](https://github.com/freelensapp/freelens/actions/workflows/integration-tests.yaml)
[](https://github.com/freelensapp/freelens/actions/workflows/trunk-check.yaml)
<!-- markdownlint-enable MD013 -->
[Freelens](https://freelens.app) is a free and open-source user interface
designed for managing Kubernetes clusters. It provides a standalone
application compatible with macOS, Windows, and Linux operating systems,
making it accessible to a wide range of users. The application aims to
simplify the complexities of Kubernetes management by offering an intuitive
and user-friendly interface.

## Downloads
See the [releases](https://github.com/freelensapp/freelens/releases) page and
download the right package for your system.
### macOS
macOS 11 or later is required.
Download either the PKG (installer) or DMG (image) package from the
[releases](https://github.com/freelensapp/freelens/releases) page. Both arm64
(M1 chip or newer) and amd64 (Intel) variants are available.
All binary packages are built on macOS 14 and should be compatible with newer
systems.
#### Homebrew
Run the following command:
```sh
brew install --cask freelens
```
### Linux
Linux with GNU C Library 2.34 or later is required. It is provided ie. by
Debian 12, Fedora 35, Mint 21, openSUSE Leap 15.4, Ubuntu 22.04 and by
rolling release distributions like Arch, Manjaro or Tumbleweed.
Download DEB or RPM (package) or AppImage (executable) from the
[releases](https://github.com/freelensapp/freelens/releases) page. Both arm64
(aarch64) and amd64 (x86_64) variants are available.
All binary packages are built on Ubuntu 22.04 and should be compatible with
new systems.
#### AppImage
The Linux AppImage file requires libz.so and libfuse.so.2. You can add them
by running:
```sh
sudo apt install libfuse2 zlib1g-dev
```
Run the application with additional arguments:
<!-- markdownlint-disable MD013 -->
```sh
./Freelens*.AppImage --no-sandbox --ozone-platform-hint=auto --enable-features=WebRTCPipeWireCapturer --enable-features=WaylandWindowDecorations --disable-gpu-compositing
```
<!-- markdownlint-enable MD013 -->
#### Flatpak
The package is available on the
[Flathub](https://flathub.org/apps/app.freelens.Freelens) App Store for
Linux.
Use GNOME Software application or run the following commands:
```sh
flatpak install flathub app.freelens.Freelens
flatpak run app.freelens.Freelens
```
The application is sandboxed. It includes bundled `kubectl` and `helm`
commands and uses the `~/.kube/config` file by default.
Flatpak adds wrappers for the `aws`, `doctl`, `gke-gcloud-auth-plugin`, and
`kubelogin` tools, running them as commands from the host system.
The terminal uses `/bin/sh` by default, but it can be switched to, for
example, `/bin/bash` for a sandboxed environment or `/app/bin/host-spawn` for
a host environment.
#### Snap
The package is available on the [Snap](https://snapcraft.io/freelens) Store
for Linux.
Use App Center application or run the following command:
```sh
snap install freelens --classic
```
#### APT repository
Run the following commands:
<!-- markdownlint-disable MD013 -->
```sh
curl -L https://raw.githubusercontent.com/freelensapp/freelens/refs/heads/main/freelens/build/apt/freelens.asc | sudo tee /etc/apt/keyrings/freelens.asc
curl -L https://raw.githubusercontent.com/freelensapp/freelens/refs/heads/main/freelens/build/apt/freelens.sources | sudo tee /etc/apt/sources.list.d/freelens.sources
sudo apt update
sudo apt install freelens
```
#### Arch User Repository
The package is available on the [Arch User Repository
(AUR)](https://wiki.archlinux.org/title/Arch_User_Repository).
Check the [freelens-bin](https://aur.archlinux.org/packages/freelens-bin)
package page.
### Windows
Windows 10 or later is required.
Download the EXE (NSIS) or MSI installers from the
[releases](https://github.com/freelensapp/freelens/releases) page.
Both the x64 (amd64) and arm64 versions of the Windows binaries are provided.
However, an EXE installer (NSIS) itself is x86 binary only even if it installs
arm64 application and then installs to `C:\Program Files (x86)\Freelens` path
by default.
The version of the MSI package has the last 4th digit always `0` and this is a
limitation of this package format.
#### WinGet
The package is available in
[WinGet](https://winstall.app/apps/Freelensapp.Freelens) Community
[repository](https://github.com/microsoft/winget-pkgs).
Run the following command:
```powershell
winget install Freelensapp.Freelens
```
The `--silent` option is supported to suppress all UI.
The `--scope user` or `--scope machine` option can be used to install it
either to local user directory or to `C:\Program Files`.
WinGet installs the application from EXE installer (NSIS).
#### Scoop
The package is available in the
[Scoop](https://scoop.sh/#/apps?q=freelens&s=1&d=0) command-line installer for
Windows.
Run the following command:
```powershell
scoop bucket add extras
scoop install freelens
```
Scoop uses MSI package to install the application.
## Development
Visit [Development](https://github.com/freelensapp/freelens/wiki/Development)
wiki page to see how to build the application from source.
Check out the [Freelens Docs](https://freelensapp.github.io/docs/) to contribute to development or create your own extension.
## Extensions
Anyone can develop extensions for Freelens and many extensions previously used
with Open Lens have already been converted.
Visit [Extensions](https://github.com/freelensapp/freelens/wiki/Extensions) wiki
page to see them and write in the [appropriate
discussion](https://github.com/freelensapp/freelens/discussions/117) if you
also want to propose yours.
## Community
Get updates about Freelens & keep in touch with our community
- Follow us on [LinkedIn](https://www.linkedin.com/company/freelensapp/)
- Join our [Discussions](https://github.com/freelensapp/freelens/discussions)
- Chat on [Discord](https://discord.gg/NjKZERK95Y)
- Discuss on [Reddit](https://www.reddit.com/r/freelens/)
- Watch us on [YouTube](https://www.youtube.com/@Freelensapp)
- Read our [Wiki](https://github.com/freelensapp/freelens/wiki)
- Open an [Issue](https://github.com/freelensapp/freelens/issues)
## Contributing
Anyone is welcome to collaborate to advance the Freelens project. Read
[CONTRIBUTING.md](CONTRIBUTING.md) to see how you can help.

## Expenses and Donations
Anyone can support the Freelens project by making donations to cover
maintenance costs and invest in its development.
For more information, see our dedicated page in our Wiki: [Expenses and
Donations](https://github.com/freelensapp/freelens/wiki/Expenses-and-Donations)
## Core Team
Each member of the core team is focused on specific roles. You can contact us
at any time according to them.
- [Roberto Bandini](https://www.linkedin.com/in/bandiniroberto/) - [@robertobandini](https://github.com/robertobandini) - Founder<br/>
General organization management, relationships, product management, community, marketing, freelens-ai extension
- [Piotr Roszatycki](https://www.linkedin.com/in/piotr.roszatycki) - [@dex4er](https://github.com/dex4er) - Maintainer<br/>
Development direction, architecture and release management, flux-cd extension, freelens-ai extension
- [Mario Offertucci](https://www.linkedin.com/in/mario-offertucci-703113b6/) - [@mariomamo](https://github.com/mariomamo) - Maintainer<br/>
UI, Docs, freelens-ai extension development management
- [Leopoldo Capuano](https://www.linkedin.com/in/leo-capuano/) - [@leo-capvano](https://github.com/leo-capvano) - Maintainer<br/>
GenAI solutions & freelens-ai extension development management
The project is growing very quickly and everyone is welcome!
If you also want to be part of it, visit the wiki page: [We want
you!](https://github.com/freelensapp/freelens/wiki/We-want-you!).
Or contact us at <
[email protected]> for any questions or suggestions!
## License
This repository is a fork of [Open
Lens](https://github.com/lensapp/lens/tree/master), the core of [Lens
Desktop](https://k8slens.dev), with the aim of carrying forward its
open-source version.
Copyright (c) 2024-2025 Freelens Authors.
Copyright (c) 2022 OpenLens Authors.
[MIT License](https://opensource.org/licenses/MIT)
", Assign "at most 3 tags" to the expected json: {"id":"14890","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"