{"id":46344,"library":"serena-agent","title":"Serena Agent","description":"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.","status":"active","version":"1.5.3","language":"python","source_language":"en","source_url":"https://github.com/oraios/serena","tags":["mcp","toolkit","coding","semantic","retrieval","agent"],"install":[{"cmd":"pip install serena-agent","lang":"bash","label":"PyPI"}],"dependencies":[],"imports":[{"wrong":"from serena import SerenaAgent","symbol":"SerenaAgent","correct":"from serena import SerenaAgent"}],"quickstart":{"code":"from serena import SerenaAgent\nfrom serena.mcp import setup_server\nimport asyncio\n\nasync def main():\n    agent = SerenaAgent()\n    await agent.initialize()\n    server = setup_server(agent)\n    await server.serve()\n\nasyncio.run(main())","lang":"python","description":"Initialize SerenaAgent, set up MCP server, and start serving."},"warnings":[{"fix":"Use `model_name='...'` instead of `model='...'`.","message":"In version 1.4.0, the constructor signature of SerenaAgent changed. The `model` argument was renamed to `model_name`.","severity":"breaking","affected_versions":">=1.4.0"},{"fix":"Set environment variables `SERENA_DB_HOST`, `SERENA_DB_PORT`, `SERENA_DB_NAME`, `SERENA_DB_USER`, `SERENA_DB_PASSWORD` to configure the database.","message":"SerenaAgent requires a running PostgreSQL database for storing embeddings. The default connection string points to localhost:5432.","severity":"gotcha","affected_versions":"all"},{"fix":"Always call `retrieve` within an async context or wrap it in `asyncio.run()`.","message":"The `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.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'1.5.3':22 'agent':2,19,37 'appear':29 'cadenc':24 'capabl':14 'code':8,34 'current':20 'edit':13 'ide':16 'irregular':26 'mcp':5,32 'month':31 'new':27 'power':4 'provid':9 'releas':23,28 'retriev':11,36 'rough':30 'semant':10,35 'serena':1 'toolkit':6,33 'version':21","created_at":"2026-06-07T12:59:28.178650+00:00","updated_at":"2026-06-07T12:59:28.178650+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'SerenaAgent' from 'serena' (/tmp/tmpfkc1t5ux/venv/lib/python3.12/site-packages/serena/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/oraios/serena","github":"https://github.com/oraios/serena","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}