===============
Getting Started
===============

**Audience**: App developers who want to build applications using the ActingWeb Python library with Flask or FastAPI.

This section will get you up and running with ActingWeb quickly, from installation through to deployment.

Quick Start (3-5 minutes)
=========================

Jump right in with a minimal Flask or FastAPI app. See :doc:`overview` for the fastest path to a working actor system.

Contents
========

.. toctree::
   :maxdepth: 2

   overview
   getting-started
   local-dev-setup
   configuration
   deployment

Learning Path
=============

1. **Overview** - 3-5 minute quickstart with minimal Flask/FastAPI app
2. **Getting Started** - More detailed walkthrough of building your first app
3. **Local Development Setup** - Install database backend (DynamoDB or PostgreSQL) and development tools
4. **Configuration** - Configure authentication, database backend, and features
5. **Deployment** - Deploy to production environments

Next Steps
==========

After completing the quickstart:

- **Explore Features**: See :doc:`../guides/index` for deep dives into specific features like OAuth2, trust relationships, and subscriptions
- **Developer API**: Learn the high-level interfaces in :doc:`../reference/interface-api`
- **MCP Integration**: Add AI client access with :doc:`../guides/mcp-quickstart`