serena-agent

library1.5.3pypypiunverified

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent. Current version: 1.5.3. Release cadence is irregular; new releases appear roughly monthly.

devops

pip install serena-agent

github ↗homepage ↗

INSTALL

IMPORT

SIG · SERENA-AGENT

serena-agent

devopspythonv1.5.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SerenaAgent

✓ from serena import SerenaAgent

✗ from serena import SerenaAgent

Initialize SerenaAgent, set up MCP server, and start serving.

from serena import SerenaAgent from serena.mcp import setup_server import asyncio async def main(): agent = SerenaAgent() await agent.initialize() server = setup_server(agent) await server.serve() asyncio.run(main())

Debug

Known issues

breakingIn version 1.4.0, the constructor signature of SerenaAgent changed. The `model` argument was renamed to `model_name`.

fix

Use `model_name='...'` instead of `model='...'`.

affects: >=1.4.0

gotchaSerenaAgent requires a running PostgreSQL database for storing embeddings. The default connection string points to localhost:5432.

fix

Set environment variables `SERENA_DB_HOST`, `SERENA_DB_PORT`, `SERENA_DB_NAME`, `SERENA_DB_USER`, `SERENA_DB_PASSWORD` to configure the database.

affects: all

gotchaThe `retrieve` method returns a list of results synchronously, but the underlying network call is asynchronous. Calling it without an active event loop will raise a RuntimeError.

fix

Always call `retrieve` within an async context or wrap it in `asyncio.run()`.

affects: all

Upgrade

Version history

1.5.3latest on PyPI · released May 26, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/oraios/serena ↗

homepagehttps://github.com/oraios/serena ↗