oraios/serena · critical · Exception

The language server manager is not initialized, indicating a

Error message

The language server manager is not initialized, indicating a problem during project initialisation. ... IMPORTANT: Stop, do not attempt workarounds. Inform the user and wait for further instructions before you continue!

What it means

Raised by Project.get_language_server_manager_or_raise (src/serena/project.py:567) when the language server manager failed to initialize during project start-up. It is a deliberate hard stop with an agent-facing message instructing the AI to halt and inform the user rather than attempt workarounds.

Source

Thrown at src/serena/project.py:567

        if self.language_server_manager is None:
            if self._language_server_manager_init_error is not None:
                return f"error ({self._language_server_manager_init_error})"
            else:
                return "not initialized"
        else:
            return "ready"

    def get_language_server_manager_or_raise(self) -> LanguageServerManager:
        if self.language_server_manager is None:
            msg = TextBuilder("The language server manager is not initialized, indicating a problem during project initialisation.")
            if self._language_server_manager_init_error is not None:
                msg.with_text(str(self._language_server_manager_init_error))
            if self._agent is not None:
                msg.with_text("For details, please check the logs. " + self._agent.get_log_inspection_instructions())
            msg.with_text(
                "IMPORTANT: Stop, do not attempt workarounds. Inform the user and wait for further instructions before you continue!"
            )
            raise Exception(msg.build())
        return self.language_server_manager

    def add_language_server(self, ls_id: LanguageServerId) -> None:
        """
        Adds a new language server to the project configuration, starting the corresponding
        server instance if the LS manager is active.
        The project configuration is saved to disk after adding the language.

        :param ls_id: the language server to add
        """
        if ls_id in self.project_config.language_servers:
            log.info(f"Language server {ls_id.value} is already present in the project configuration.")
            return

        # start the language server (if the LS manager is active)
        if self.language_server_manager is None:
            log.info("Language server manager is not active; skipping language server startup for the new language.")
        else:

View on GitHub (pinned to 7fcbca7e62)

Solutions

1. Read the Serena logs for the stored _language_server_manager_init_error root cause
2. Install the prerequisites for the relevant language server (e.g. JDK 17+ for Java, Node for TS) or fix the network/proxy so the LS binary can download
3. Stop and ask the user how to proceed — do not retry with workarounds, per the error's own instruction

Example fix

// before
ls_manager = project.get_language_server_manager_or_raise()  # crashes on broken env
// after
try:
    ls_manager = project.get_language_server_manager_or_raise()
except Exception as e:
    print(f'Language server init failed: {e}. Ask the user for instructions and stop.')
    raise

if project._language_server_manager_init_error is not None:
    logging.error('LS init failed: %s', project._language_server_manager_init_error)

try:
    lsm = project.get_language_server_manager_or_raise()
except Exception as e:
    print(f'{e}')  # includes instruction to stop and inform the user
    raise

When it happens

Trigger: Language server download/startup failure (missing runtime like node/jvm for the language, network failure while downloading the LS binary), unsupported language config, or any exception stored in _language_server_manager_init_error during __init__.

Common situations: No Java installed for Eclipse JLS; no node/npm for TypeScript LS; offline/air-gapped environments blocking LS download; broken language configuration in .serena/project.yml.

Related errors

• Invalid language server: '{orig_language_str}'.\nValid value
• Failed to start {len(exceptions)} language server(s): {failu
• Cannot extract symbols from file {relative_path}. Active lan
• No symbol declaration found at the location of the regex mat
• Language server is missing required capabilities: {', '.join

AI-assisted analysis of oraios/serena@7fcbca7e62 (2026-08-29). Data as JSON: /api/errors/bc00543c41cf82ed. Report an issue: GitHub.