Quickstart in an Amp orb

An Amp orb is the fastest way to run the portal. The repository declares everything the orb needs:

File	What it does
.agents/setup	Installs Postgres, creates the factory and factory_test databases, and installs the backend and frontend dependencies. Safe to run again.
.amp/services.yaml	Declares the api, web and docs services, their ports, health check and portals.

1. Add the GitHub settings to the project. Register the apps with GitHub apps, then add the values from Configuration as Amp project environment variables and secrets. .amp/services.yaml sets DATABASE_URL and APP_BASE_URL for you.

2. Start the services.

   amp orb services ensure

   This starts:

   Service	Directory	Port	Portal
   api	backend/	8000	none; the web app proxies /api to it
   web	frontend/	assigned	Software Factory
   docs	docs/	assigned	MateFactory docs

   The api service runs alembic upgrade head before it starts, so the database is always at the latest migration.

3. Open the Software Factory portal and click Sign in with GitHub.

The portal URL changes per thread

APP_BASE_URL is the orb’s portal URL, and GitHub only redirects to the callback URL you registered. Register the OAuth App and GitHub App with the URL of the orb you use, or use a deployed portal for day-to-day work.

Next steps

• Connect Daytona so threads get sandboxes.
• Create a project from a repository.
• Start a thread.