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

# Employee onboarding · DOSIA × ByteSpike

> Get every team member through the DOSIA → ByteSpike loop in 5 minutes: install, switch to enterprise mode, enterprise SSO, auto-pick up allowed models, start chatting / vision / image generation.

<Note>
  **When this applies**: your organization already bought ByteSpike, your admin already created your lark account + topped up balance. You got this doc and in \~5 minutes you'll be calling every Claude / GPT / Gemini / DeepSeek / Doubao model the admin has allowed.
</Note>

## 1. Install DOSIA

<Tabs>
  <Tab title="On the internal network">
    Grab the latest build from the NAS shared drive:

    ```bash theme={null}
    /Volumes/cloud/apps/mac/DOSIA-0.2.23-arm64.dmg   # Apple Silicon (M1/M2/M3/M4)
    /Volumes/cloud/apps/mac/DOSIA-0.2.23.dmg         # Intel Mac
    ```
  </Tab>

  <Tab title="Public download">
    [github.com/leave1206/dosia-releases/releases/latest](https://github.com/leave1206/dosia-releases/releases/latest)
  </Tab>
</Tabs>

<Warning>
  If the first launch reports **"file is damaged"** or **"cannot be opened because it is from an unidentified developer"**, run this in Terminal:

  ```bash theme={null}
  xattr -cr /Applications/DOSIA.app
  ```

  Then relaunch DOSIA. That's macOS Gatekeeper's default block on un-notarized dmgs — nothing wrong with the app itself.
</Warning>

## 2. Switch to enterprise mode

<Steps>
  <Step title="Open Settings">
    After DOSIA launches, top menu: **DOSIA → Settings** (shortcut `⌘,`).
  </Step>

  <Step title="Switch Deploy Mode">
    In the left nav click **Deploy Mode**, switch the mode from "Personal" to **"Enterprise"**.
  </Step>

  <Step title="Fill in the enterprise service URL">
    Paste the URL your admin gave you — the default is:

    ```
    http://122.51.0.230:3012
    ```

    (If your admin provided an internal-network address or a self-hosted domain, use what the admin said.)
  </Step>

  <Step title="Click Save">
    The blue "Save config" button at the bottom of the page. DOSIA will prompt you to restart — go ahead and restart.
  </Step>
</Steps>

<Note>
  That URL is the DOSIA **enterprise web backend** (apps/web deployment on Tencent Cloud), **separate from** the ByteSpike LLM Gateway (`https://llm.bytespike.ai`) — two services, different hosts, different ports. The backend handles ByteSpike config sync, lark OAuth proxy, and enterprise workspace management; the LLM Gateway handles the actual model calls. Employees don't need to care about the distinction — admin gives you the URL, you fill it in.

  If the service URL changes and admin sends a new one, employees just update **Settings → Deploy Mode** → save. **No reinstall needed.**
</Note>

## 3. Enterprise SSO login

<Steps>
  <Step title="Confirm admin has granted access">
    Ask the admin to add your **lark employee ID / email** to the ByteSpike allowlist. The admin does this in [console.bytespike.ai](https://console.bytespike.ai) or in the lark group admin backend — you don't have to do anything.
  </Step>

  <Step title="DOSIA triggers lark OAuth automatically">
    After restart, DOSIA detects enterprise mode and pops the lark authorization page automatically. The first time it opens the browser; once authorized you come back to DOSIA.
  </Step>

  <Step title="Logged in">
    The top-right corner of DOSIA should now show your lark avatar + email.
  </Step>
</Steps>

<Note>
  No lark authorization page appeared / stuck on "initializing"? Jump to [Section 6 FAQ](#6-faq) to investigate.
</Note>

## 4. Auto-pick up the allowed models

Once logged in, DOSIA calls ByteSpike automatically to fetch your allowed model list — no manual API key config needed.

<Steps>
  <Step title="Open the AI Models tab">
    **Settings → AI Models** (left nav).
  </Step>

  <Step title="Confirm the 'ByteSpike Shared' provider shows up">
    The AI Models list should contain a provider called **"ByteSpike Shared"** (pre-configured by admin under enterprise mode).
  </Step>

  <Step title="Confirm the model list">
    Expand "ByteSpike Shared" — you should see every model the admin has granted you:

    * **Claude** family: Opus 4.8 / Sonnet 4.6 / Haiku 4.5
    * **OpenAI** family: GPT-5-4 / GPT-5-4-mini / GPT-5-5, etc.
    * **Gemini** family: Gemini Pro / Gemini 3.5 Flash
    * **DeepSeek**: DeepSeek v4 Pro / v4 Flash
    * **ByteDance / Doubao**: Doubao Seed 2.0 Pro, etc.
    * **Image / video**: Nano Banana, Veo 3.1, etc. (if admin has granted multimodal capability)

    The exact list depends on your group's permission config — if it doesn't match, talk to admin.
  </Step>
</Steps>

## 5. Start using it

<CardGroup cols={2}>
  <Card title="Send a text message" icon="message">
    Pick a model at the top of the main chat box → type message → hit enter. Same interaction across vendors — the ByteSpike gateway routes automatically.
  </Card>

  <Card title="Vision (image input)" icon="image">
    Drag an image into the chat box (or paste it). DOSIA calls the image-tools MCP's `analyze_image` tool, which invokes a vision model to recognize the image.
  </Card>

  <Card title="Image generation" icon="palette">
    Ask for an image in the chat ("draw a cyberpunk cat") — the agent calls the `generate_image` MCP tool, routing through Nano Banana / GPT Image, etc.
  </Card>

  <Card title="Video generation" icon="video">
    Same idea as images — ask for "generate a video", the agent calls `generate_video` MCP, routing through Veo 3.1, etc.
  </Card>
</CardGroup>

<Note>
  **Billing is transparent**: each model call's USD cost shows in the "credits" hint below the chat box. Failed calls (5xx / network errors) **don't bill**.
</Note>

## 6. FAQ

<AccordionGroup>
  <Accordion title="&#x22;ByteSpike Shared&#x22; provider does not appear">
    Likely causes:

    1. Enterprise service URL is wrong → go back to **Settings → Deploy Mode**, double-check the URL, save again
    2. Lark grant hasn't taken effect → ask admin to confirm your employee ID is on the ByteSpike allowlist
    3. SSO authorization expired → DOSIA **Settings → My Account**, click sign out then sign in again
  </Accordion>

  <Accordion title="Chat box says &#x22;insufficient balance&#x22;">
    The org wallet ran out. Screenshot + ask admin — once admin tops up at [console.bytespike.ai/billing](https://console.bytespike.ai/billing), it recovers immediately.
  </Accordion>

  <Accordion title="A specific model returns &#x22;permission denied&#x22; / &#x22;model not allowed&#x22;">
    Admin hasn't granted your group access to that model. Ask admin to go to [llm.bytespike.ai/admin](https://llm.bytespike.ai/admin) → Users → your account → Allowed Models, and tick the matching model group.
  </Accordion>

  <Accordion title="Image / video generation tab is missing">
    Multimodal capability is granted separately (independent of text models). Once admin adds `image` / `video` capability to your group in console, DOSIA picks up the tool after a restart.
  </Accordion>

  <Accordion title="After lark authorization DOSIA freezes / loops on login">
    Clear DOSIA's local state:

    ```bash theme={null}
    rm -rf ~/Library/Application\ Support/DOSIA/auth
    ```

    Then relaunch DOSIA. If still broken, screenshot + DM the admin on lark.
  </Accordion>
</AccordionGroup>

## What's next

* Want to call the ByteSpike API directly with your own key (not via DOSIA)? See [Configure client](./configure-client) — base URL + key config per SDK.
* Want to know how to call each endpoint? See [API Reference](./api-reference/text/claude-messages) — protocol / shape / 4xx error codes.
* Want the full model catalog + pricing? See [bytespike.ai/pricing](https://bytespike.ai/pricing).

Any questions, find your admin or @ByteSpike Ops in the lark group.