> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altitut-sma-center.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart: From Zero to Published Post on Altitut

> Follow this step-by-step guide to connect your social accounts, configure API keys, and publish your first post with Altitut in under ten minutes.

This guide walks you through everything you need to do to go from a fresh Altitut installation to publishing your first social post. You will connect your social accounts, wire up the required API keys, run your first Competitor Scout to populate your intelligence library, build a Content Pack, and send a post live — all in a single session.

**1. Connect Your Social Accounts**

Altitut publishes posts through the **Upload-Post** service, which acts as the bridge to LinkedIn, Facebook, and Instagram. Before you can post, you need to connect your social accounts inside the Upload-Post dashboard.

1. Log in to your [Upload-Post dashboard](https://app.upload-post.com).
2. Create a **Profile** (for example, `my-brand`). This name will become your `UPLOAD_POST_PROFILE` environment variable.
3. Navigate to **Connected Accounts** inside that profile and click **Add Account**.
4. Authenticate each platform (LinkedIn, Facebook, Instagram) using the OAuth flow provided.
5. Copy your **Upload-Post API key** from the dashboard — you will need it in the next step.

> [!NOTE]
>
> Altitut reads the list of connected accounts from Upload-Post at runtime. Any account you connect in the Upload-Post dashboard will automatically appear in the **Destinations** step of the Auto-Post Composer.

**2. Configure API Keys**

Altitut requires several API keys to power its AI and data features. Copy the environment template and fill in your values:

```bash theme={null}
cp .env.example .env
```

Open `.env` and add the following:

```bash .env theme={null}
# Required — AI inference and vector embeddings
OPENAI_API_KEY=sk-...

# Required — competitor discovery and web research
EXA_API_KEY=exa-...

# Required — Instagram profile and reel scraping
APIFY_TOKEN=apify_...

# Required — social publishing via Upload-Post
UPLOAD_POST_API_KEY=up-...
UPLOAD_POST_PROFILE=my-brand

# Required — your Firebase project
FIREBASE_PROJECT_ID=your-firebase-project-id

# Optional — Telegram bot integration
TELEGRAM_BOT_TOKEN=123456:ABC-...
```

> [!WARNING]
>
> Never commit your `.env` file to version control or expose these keys on the client side. All API calls that use these credentials are made from the backend — they are never sent to the browser.

After saving the file, start your development server so the new environment variables are picked up:

```bash theme={null}
npm run dev
```

Open [http://localhost:3000](http://localhost:3000) to see the Altitut dashboard.

> [!TIP]
>
> See the [Configuration](https://docs.altitut-sma-center.com/configuration.md) page for a full breakdown of what each key is used for, Firebase setup instructions, and the optional Telegram bot setup.

**3. Run Your First Competitor Scout**

With your keys in place, you are ready to build your first intelligence pack. Navigate to the **Competitors Analysis** tab in the dashboard and click **Scout a competitor**.

The scout runs through several stages automatically:

| Stage | What Happens |
| - | - |
| Discover | Exa AI finds competitors matching your query |
| Website | Apify crawls each competitor's public website |
| Social | Maps each competitor's social media presence |
| Research | Deep-dives into brand positioning and messaging |
| Synthesize | Produces layered synthesis passes using AI |
| Save | Writes the intelligence pack to your database and indexes it for AI Copilot queries |

To run the scout:

1. Enter a description of your product and optionally list any competitors you already know.
2. Walk through the steps: **Discover → Website → Social → Research → Synthesize**.
3. Click **Assemble pack** then **Save**.

The pack appears in the dashboard and is immediately available to the **AI Copilot** for queries.

> [!NOTE]
>
> A full scout with several competitors typically completes in **3 to 6 minutes** depending on website complexity. You can monitor real-time stage progress in the dashboard while the pipeline runs.

**4. Create Your First Content Pack**

Navigate to the **Content Creation** tab and click on an existing pack, or create a new one. You can also send an Instagram reel URL to your Telegram bot to generate a pack automatically.

Each pack is structured into five sections — **Overview**, **Strategy**, **Series**, **Recipe**, and **Execution** — giving your team a clear path from idea to published post.

> [!TIP]
>
> Use the **AI Copilot** (click **Chat** on any pack) to ask questions like "What content themes are my competitors using?" before creating a pack. Grounding your strategy in competitor intelligence leads to more differentiated content.

**5. Publish Your First Post**

Open the **Auto-Post Composer** by clicking **Post** on a content pack (or opening the composer from the sidebar). The composer walks you through the following steps:

**1 — Media:** Upload your video or images. Files are uploaded to Firebase Storage and a download URL is passed to Upload-Post at publish time.

**2 — Destinations:** Select the social accounts you want to publish to. All accounts connected in your Upload-Post profile appear here automatically.

**3 — Copy:** Write your caption manually or click **Generate captions** to produce a platform-tailored caption from your media and content pack context.

**4 — Review & Publish:** Preview your post, then click **Publish** to send it live.

After publishing, the post appears in **Post History** where you can track its delivery status across all destinations.

> [!NOTE]
>
> You have now completed the full Altitut workflow: intelligence gathering → content creation → publishing. From here, explore the feature pages to go deeper on each capability, or visit the [Configuration](https://docs.altitut-sma-center.com/configuration.md) page to fine-tune your setup.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.