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

# Quickstart

> Build your first AI agent in 5 minutes

## What will you build?

Junis is an AI workforce platform where you build and deploy a team of AI agents without writing code. This quickstart takes you from signup to a working agent in about 5 minutes: create an account, build an agent in the web interface, chat with it, and optionally call it through the OpenAI-compatible API.

This quickstart guide will help you:

1. **Create an account** and set up your organization
2. **Build your first agent** using the web interface
3. **Test your agent** in the chat interface
4. **(Optional) Integrate via API** using the OpenAI-compatible endpoint

<Note>
  **Prerequisites**: A Google account for authentication. No coding required for steps 1-3!
</Note>

***

## Step 1: Create Your Account

<Steps>
  <Step title="Sign Up">
    Go to [junis.ai](https://junis.ai) and click **"Sign in with Google"**
  </Step>

  <Step title="Complete Onboarding">
    You'll be redirected to the onboarding page. Fill in:

    * **Organization Name**: Your company or personal workspace name
    * **Display Name**: How you want to be addressed
  </Step>

  <Step title="Access Dashboard">
    You'll land on the main dashboard. This is your command center!
  </Step>
</Steps>

***

## Step 2: Create Your First Agent

<Steps>
  <Step title="Navigate to Orchestration">
    Click **"Team Management"** dropdown in the Navigation Bar, then select **"Agent Orchestration"**
  </Step>

  <Step title="Create New Agent">
    Click the **"New Agent"** button

    Fill in the form:

    ```yaml theme={null}
    Name: MyFirstAgent
    Type: LLM Agent
    Model: claude-haiku
    Description: A helpful AI assistant
    ```
  </Step>

  <Step title="Write Instructions">
    In the **"Instructions"** field, write:

    ```text theme={null}
    You are a helpful AI assistant. When users ask questions:
    1. Provide clear, concise answers
    2. Use friendly, professional tone
    3. Ask clarifying questions when needed

    Always be helpful and informative.
    ```

    <Tip>
      Good instructions are key to agent performance! Be specific about behavior and tone.
    </Tip>
  </Step>

  <Step title="Save Agent">
    Click **"Create"** to save your agent

    <Check>Agent created successfully!</Check>
  </Step>
</Steps>

***

## Step 3: Test Your Agent

<Steps>
  <Step title="Open Chat Interface">
    Click **"Chat"** in the sidebar
  </Step>

  <Step title="Send a Message">
    Type a message and hit **Enter**:

    ```text theme={null}
    Hello! What can you help me with?
    ```

    Watch as your agent responds in real-time! 🚀
  </Step>

  <Step title="Explore Features">
    Try these features:

    * **File Upload**: Click 📎 to attach documents
    * **Voice Input**: Click 🎤 to speak your message
    * **Session History**: See past conversations in the sidebar
  </Step>
</Steps>

<Success>
  **Congratulations!** You've created and tested your first Junis agent! 🎉
</Success>

***

## Step 4: Integrate via API (Optional)

Now let's call your agent programmatically using our OpenAI-compatible API.

<Steps>
  <Step title="Generate API Key">
    1. Navigate to **"Dashboard"** → **"API Keys"**
    2. Click **"Create New API Key"**
    3. Enter:
       * **Name**: My First API Key
       * **Description**: Testing quickstart
       * **Scopes**: (leave default)
    4. **IMPORTANT**: Copy the key immediately - it won't be shown again!
  </Step>

  <Step title="Test with cURL">
    Open your terminal and run:

    ```bash theme={null}
    curl -X POST https://api.junis.ai/api/external/v1/chat/completions \
      -H "X-API-Key: YOUR_API_KEY_HERE" \
      -H "Content-Type: application/json" \
      -d '{
        "messages": [
          {"role": "user", "content": "Hello from API!"}
        ],
        "stream": false
      }'
    ```

    <Check>You should receive a response from your agent!</Check>
  </Step>

  <Step title="Enable Streaming">
    For real-time token-by-token responses:

    ```bash theme={null}
    curl -N -X POST https://api.junis.ai/api/external/v1/chat/completions \
      -H "X-API-Key: YOUR_API_KEY_HERE" \
      -H "Content-Type: application/json" \
      -d '{
        "messages": [
          {"role": "user", "content": "Tell me a story"}
        ],
        "stream": true
      }'
    ```
  </Step>
</Steps>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Agent System Overview" icon="diagram-project" href="/getting-started/agent-system">
    Learn about Sequential, Parallel, and Loop agents
  </Card>

  <Card title="Connect External Services" icon="plug" href="/guides/mcp/overview">
    Integrate GitHub, Firecrawl, and more via MCP
  </Card>

  <Card title="Scheduled Tasks" icon="clock" href="/guides/tools/schedules">
    Automate workflows with flexible scheduling
  </Card>

  <Card title="Tools & Capabilities" icon="wrench" href="/guides/tools/overview">
    Explore all available tools and features
  </Card>
</CardGroup>

***

## Common Issues

<AccordionGroup>
  <Accordion title="Agent not responding">
    **Solutions**:

    1. Check if agent is **active** (toggle in admin panel)
    2. Verify LLM model is available (check status page)
    3. Refresh the page and try again
    4. Check browser console for errors (F12)
  </Accordion>

  <Accordion title="API key not working">
    **Solutions**:

    1. Ensure you're using the correct header: `X-API-Key`
    2. Check if key is still **active** in admin panel
    3. Verify you're calling the correct endpoint: `/api/external/v1/chat/completions`
    4. Check for typos in the API key
  </Accordion>

  <Accordion title="Slow responses">
    **Possible causes**:

    * **Model**: Claude Opus is slower than Haiku. Switch to Haiku for faster responses
    * **RAG**: Large knowledge bases increase latency. Optimize document size
    * **MCP**: External service calls add time. Use caching when possible
    * **Network**: Check your internet connection
  </Accordion>
</AccordionGroup>

***

## Need Help?

<CardGroup cols={3}>
  <Card title="Documentation" icon="book" href="/getting-started/introduction">
    Browse comprehensive guides
  </Card>

  <Card title="Email Support" icon="envelope" href="mailto:contact@junis.ai">
    Contact our team directly
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/authentication">
    Explore full API documentation
  </Card>
</CardGroup>