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

# TikTok review

> Connect to the Truffle review workspace and try the TikTok integration.

Use the launcher below to connect to our review workspace on **truffle-3615**,
authorize TikTok in your browser, and start chatting. You do not need a Truffle
device or the Symphony desktop app.

Truffle is a personal AI device. The TikTok app runs on that device and lets its
owner read **their own** TikTok profile, account stats, and public video library.
It is read-only: nothing is posted, edited, or deleted on TikTok, and it cannot
open other accounts or search public TikTok.

## Start the review

Use a **Linux or macOS desktop terminal** with **Python 3.12 or newer** and
`curl` installed. Linux also needs Python's `venv` package. Run:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/deepshard/docs/main/scripts/tiktok-review.sh | bash
```

The launcher downloads the tested reviewer CLI, checks its SHA256, installs it
and Chromium in your user account, then:

1. Asks you to paste the **Truffle invitation** from the [Test access](#test-access)
   section below. Input is hidden. This connects to the workspace on truffle-3615.
2. Starts the TikTok installer. Accept the prompt, sign in to TikTok in the
   browser that opens, and authorize the integration.
3. Opens a chat in your terminal. Try **Use TikTok to show my profile and
   account stats.**

Use your own TikTok login. If TikTok is already installed in the review
workspace, the launcher opens chat directly using that existing connection.

## Test access

Reviewer workspace on truffle-3615, dedicated to this TikTok review. No Truffle
hardware or signup is needed.

* **Username:** `tiktok-test`
* **Invitation** (paste it at the launcher's hidden prompt; it is the test
  account password in the submission):

```text theme={null}
truffle://remote/setup?deviceId=truffle-3615&sessionToken=d4201524-0825-4087-8c1b-90dcda5ca68e&clientUserId=35598109&remoteAddress=tunnel.us.0.itsalltruffles.com%3A443&jwt=eyJhbGciOiJSUzI1NiIsImtpZCI6InJlbGF5LWtleS0xIiwidHlwIjoiSldUIn0.eyJpc3MiOiJ0cnVmZmxlLWJhY2tlbmQiLCJhdWQiOiJ0cnVmZmxlLXJlbGF5Iiwic3ViIjoiZGV2aWNlLWxvY2FsLWNsaWVudCIsImRldmljZV9pZCI6InRydWZmbGUtMzYxNSIsInNjb3BlIjoicmVsYXk6aHR0cCByZWxheTpncnBjIiwiaWF0IjoxNzkwMDUzODg3LCJuYmYiOjE3OTAwNTM4ODcsImV4cCI6MTc5NzgyOTg4NywianRpIjoiYzJjMDllYzktMTdiYy00OTg0LWFkNGYtYWE2MDBkYjcwYTc4In0.Ec8N0hX0Y1FHPp7jyyMne9XuVPxwSkltkoYbl6sFWPqoR0u2VugVWt6aUOsYXVMVT1PrETdqr-qwEWB1WgkJV0gmlUoI3GrDcq4OIyDDxe5MDNnHC-icspLVnbHLU21H9eNKQriZ5x5-yn8xLzvMySinbWS05julegTMrN0D-Wx38n_pENVVy223ekOVZpOlUylqE2aFyFM4qYP-rHv_ZHhE7miaJawtik6fvfyAa9MceuQQFfPT9SH4WAWDUpxmdDnbZbyUx20AizzLzZNOFRsOGPEnlaQfTm80xjejvd6iGEllcOFE9GvmDaQSL1lgy9Ajy74Qvo7Ikw1DWJ7cpQ&expiresAt=2026-12-21T05%3A11%3A27Z
```

You can also [download the invitation as a file](https://raw.githubusercontent.com/deepshard/docs/main/downloads/tiktok-review/invitation.txt).
The invitation is valid until 2026-12-21 and grants access only to this
review workspace. Ask the app owner for a replacement if it has expired.

Run the same command to return later. Your local setup and Truffle connection
are saved separately from your usual Truffile settings in
`~/.local/share/truffle-tiktok-review`.

[View or download the launcher](https://raw.githubusercontent.com/deepshard/docs/main/scripts/tiktok-review.sh).
You can also download it, inspect it, and run `bash tiktok-review.sh`.

## Try the integration

Each prompt below maps to one requested scope.

* **Use TikTok to show my profile.** — `user.info.basic` and `user.info.profile`
  (display name, username, avatar, bio, profile link).
* **What are my TikTok follower, following, likes, and video counts?** —
  `user.info.stats`.
* **List my 10 most recent TikTok videos.** — `video.list`. Returns your own
  public videos, newest first, with share links.
* **Show the current view, like, comment, and share counts for the first two
  videos in that list.** — `video.list`, exact video IDs from the previous step.

Every prompt reads only the account you authorized. There is no posting,
uploading, commenting, or deleting, and no access to other users' data.

## Troubleshooting

* **TikTok refuses the sign-in or authorization:** Check which TikTok account
  you used. Contact the app owner if your review account cannot authorize; we
  can add it to the app's test users or coordinate reviewer access.
* **Expired or rejected invitation:** Ask the Truffle owner for a replacement.
  Rerun with `curl -fsSL https://raw.githubusercontent.com/deepshard/docs/main/scripts/tiktok-review.sh | bash -s -- --reconnect`
  to enter it.
* **No browser window:** Run from your desktop terminal. An SSH-only terminal
  cannot display the sign-in browser on your computer.
* **Missing Chromium system libraries on Linux:** Run
  `~/.local/share/truffle-tiktok-review/20260909.1/venv/bin/python -m playwright install-deps chromium`,
  then rerun the launcher. This dependency command may request administrator access.
* **Python or venv missing:** Follow the [Python installation steps](/sdk/installation#install-python).

The reviewer build has been validated on Linux with Python 3.12. macOS is
supported by the launcher but has not been validated in this review run.
See [TikTok's Login Kit documentation](https://developers.tiktok.com/doc/login-kit-web)
for authorization and app-review requirements.