Python

Create a new directory for your project:

mkdir my-app
cd my-app

It’s recommended to create a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows use: venv\Scripts\activate

Install the ActorCore client package:

pip install actor-core-client

Create a file actors/app.ts in your project with your actor definition:

import { actor, setup } from "actor-core";

// Create actor
const counter = actor({
  state: { count: 0 },
  actions: {
    increment: (c, x: number) => {
  	c.state.count += x;
  	c.broadcast("newCount", c.state.count);
  	return c.state.count;
    }
  }
});

// Create the application
export const app = setup({
  actors: { counter },
  cors: { origin: "*" } // Configure CORS for your production domains in production
});

// Export app type for client usage
export type App = typeof app;

Create a new file main.py:

import asyncio
from actor_core_client import AsyncClient

async def main():
    # Replace with your endpoint URL after deployment
    client = AsyncClient("http://localhost:6420")
    
    # Get or create an actor instance
    counter = await client.get("counter")
    
    # Subscribe to events using callback
    def on_new_count(msg):
        print(f"Event: {msg}")
        
    counter.on_event("newCount", on_new_count)
    
    # Call an action
    result = await counter.action("increment", 5)
    print(f"Action result: {result}")
    
    # Wait to receive events
    await asyncio.sleep(1)
    
    # Clean up
    await counter.disconnect()

if __name__ == "__main__":
    asyncio.run(main())

In the code above, subscription is done with on_event callbacks, but you can also subscribe directly with receive() calls, using the SimpleClient (and AsyncSimpleClient) interfaces. See our sample usage for more details.

Launch the development server with:

npx @actor-core/cli@latest dev actors/app.ts

This will automatically start your app and open the studio in your browser. The studio supports hot-reloading, state inspection, visual RPC testing, and more debugging tools.

In a separate terminal, run your Python code:

python main.py

You should see output like:

Event: 5
Action result: 5

Run it again to see the state update.

Now that you have your project running, deploy your application to one of these platforms: