c6af9e284a
Tests / catch-all (windows-latest) (push) Has been cancelled
Tests / jvm (macos-latest) (push) Has been cancelled
Tests / jvm (ubuntu-latest) (push) Has been cancelled
Tests / jvm (windows-latest) (push) Has been cancelled
Tests / native (macos-latest) (push) Has been cancelled
Tests / native (ubuntu-latest) (push) Has been cancelled
Tests / native (windows-latest) (push) Has been cancelled
Tests / niche (ubuntu-latest) (push) Has been cancelled
Tests / other-langs (macos-latest) (push) Has been cancelled
Tests / other-langs (ubuntu-latest) (push) Has been cancelled
Tests / other-langs (windows-latest) (push) Has been cancelled
Tests / catch-all (macos-latest) (push) Has been cancelled
Tests / catch-all (ubuntu-latest) (push) Has been cancelled
Docs Build / build (push) Has been cancelled
Docs Build / deploy (push) Has been cancelled
CodeQL Advanced / Analyze (actions) (push) Has been cancelled
CodeQL Advanced / Analyze (javascript-typescript) (push) Has been cancelled
CodeQL Advanced / Analyze (python) (push) Has been cancelled
Codespell / Check for spelling errors (push) Has been cancelled
Build and Push Docker Images / build-and-push (push) Has been cancelled
52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# Installation
|
|
|
|
## Prerequisites
|
|
|
|
**Package Manager: uv**
|
|
|
|
Serena is managed by `uv`.
|
|
If you do not have it yet, install it following the instructions [here](https://docs.astral.sh/uv/getting-started/installation/).
|
|
|
|
**Language-Specific Requirements**
|
|
|
|
When using the language server backend, some additional dependencies may need to be installed
|
|
to support certain languages.
|
|
See the [Language Support](language-servers) page for the list of supported languages.
|
|
Many dependencies are installed by Serena on the fly, but if a language requires dependencies
|
|
to be provided manually, this is mentioned in the notes below the respective language.
|
|
|
|
(install-serena)=
|
|
## Installing and Initialising Serena
|
|
|
|
With `uv` installed and on your PATH, install Serena with this command:
|
|
|
|
uv tool install -p 3.13 serena-agent
|
|
|
|
Upon completion, the command `serena` should be available in your terminal.
|
|
|
|
To test the installation and initialise Serena, run one of the following commands:
|
|
|
|
* `serena init`
|
|
if you intend to use the default language intelligence backend (language servers)
|
|
* `serena init -b JetBrains`
|
|
if you intend to use the JetBrains backend (which uses the [JetBrains plugin](025_jetbrains_plugin))
|
|
|
|
Note that you can switch backends at any time via Serena's [configuration](050_configuration).
|
|
|
|
## Updating Serena
|
|
|
|
To update Serena to the latest version, run:
|
|
|
|
uv tool upgrade serena-agent
|
|
|
|
:::{tip}
|
|
To keep informed about updates, make sure you regularly open [Serena's Dashboard](060_dashboard),
|
|
where we will announce releases along with the new features and improvements they bring.
|
|
:::
|
|
|
|
## Uninstalling Serena
|
|
|
|
Serena can be uninstalled with the following command:
|
|
|
|
uv tool uninstall serena-agent
|