{"id":24590,"library":"simile","title":"Simile","description":"A Python SDK for interfacing with Simile AI agents in simulations. Version 0.5.4, pre-1.0 rapid development.","status":"active","version":"0.5.4","language":"python","source_language":"en","source_url":"https://github.com/simile-team/simile-sdk","tags":["simulation","ai agents","sdk"],"install":[{"cmd":"pip install simile","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"HTTP client for API calls","package":"httpx","optional":false},{"reason":"Data validation","package":"pydantic","optional":false}],"imports":[{"note":"Top-level import changed in 0.4.0; submodule import no longer works.","wrong":"from simile.agent import Agent","symbol":"Agent","correct":"from simile import Agent"},{"note":"Simulation is now exported at package level.","wrong":"from simile.simulation import Simulation","symbol":"Simulation","correct":"from simile import Simulation"},{"note":"Used to configure agent personality and knowledge base.","symbol":"AgentConfig","correct":"from simile import AgentConfig"}],"quickstart":{"code":"from simile import Agent, Simulation\n\n# Create an agent\nagent = Agent(\n    name=\"CustomerBot\",\n    api_key=os.environ.get(\"SIMILE_API_KEY\", \"\"),\n    model=\"gpt-4\"\n)\n\n# Create a simulation\nsim = Simulation(agents=[agent])\n\n# Run a conversation\nresponse = sim.run(\"Hello, how are you?\")\nprint(response)","lang":"python","description":"Initialize a Simile agent and run a simple simulation."},"warnings":[{"fix":"Use top-level imports: `from simile import Agent, Simulation`.","message":"In v0.5.0, the import paths were flattened. `from simile import Agent` replaces `from simile.agent import Agent`. Old imports will break.","severity":"breaking","affected_versions":">=0.5.0"},{"fix":"Set `SIMILE_API_KEY` env var or pass `api_key` explicitly.","message":"API key must be set; either via `SIMILE_API_KEY` environment variable or `api_key` parameter. If missing, SDK will raise an `AuthError`.","severity":"gotcha","affected_versions":">=0.4.0"},{"fix":"Use `AgentConfig(model='gpt-4')` and pass it to `Agent(config=...)`.","message":"The `model` parameter in `Agent` is deprecated since 0.5.2. Use `agent_config` with `AgentConfig` instead.","severity":"deprecated","affected_versions":">=0.5.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use `from simile import Agent`.","cause":"Import path changed in v0.5.0.","error":"ImportError: cannot import name 'Agent' from 'simile.agent'"},{"fix":"Set the environment variable `SIMILE_API_KEY` or pass `api_key` to Agent constructor.","cause":"Missing or empty SIMILE_API_KEY environment variable.","error":"AuthError: No API key provided"},{"fix":"Use `AgentConfig(model='gpt-4')` and pass as `config` to Agent.","cause":"`model` parameter removed in 0.6.0 (future).","error":"TypeError: Agent.__init__() got an unexpected keyword argument 'model'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}