Connecting to sources…

How to build Vector 2.0

140 steps to build Vector 2.0, with the source documents.

Vector 2.0 $249.99 (anki.bot, open-box from $189.99); wire-pod is free and replaces the official subscription from $11.99/month

Buy parts

  • Create a Stratus account

    Create an account at stratus.anki.bot and validate the email address. Complete this before turning Vector on for the first time, because activation can take up to 24 hours.

  • Claim 30 days of membership

    Paid membership is required for “Hey Vector” voice commands and AI. New Vector orders include a free first 30 days; email [email protected] with Vector's 8-character serial number (ESN) from its underside and the order number.

  • Prepare a USB power source

    Prepare a USB power source such as an adapter, USB port, or power bank with at least 5V and 1A output.

  • Buy the OSKR Robot Kit

    Buy the OSKR kit to create your own features and modify the source code to adjust Vector's behaviors, animations, and more.

  • Check robot and computer prerequisites

    Use an Anki or Digital Dream Labs Vector robot, including production, OSKR, or dev-unlocked versions. Use a supported computer or Android 6.0+ phone, plus a Bluetooth-capable device; distributions with pacman, dnf, or apt are supported.

Software

  • Enable the wire-pod background service

    Run setup.sh from the ~/wire-pod directory to enable the systemd daemon.

  • Start the wire-pod service

    Restart the computer to start the service automatically, or start it immediately with systemctl.

  • View wire-pod logs

    Use journalctl to display logs live and filter for start.sh.

  • Disable the wire-pod daemon

    Run the daemon-disable option of setup.sh from the ~/wire-pod directory.

  • Install the Debian or Ubuntu update

    Download wirepod_[arch]_v#.#.#.deb for the system architecture from the latest WirePod release, then install it with apt install.

  • Update the background daemon installation

    Stop the wire-pod service, run update.sh, then enable and start the daemon again.

  • Install the Windows updater

    Download WirePodInstaller-v#.#.#.exe from the latest WirePod release and install it; the update does not erase user data.

  • Install the macOS WirePod update

    Quit WirePod, download and mount WirePod-v#.#.#.dmg, drag the app into Applications, allow an overwrite, and launch it from Finder; no user data will be erased.

  • Install WirePod on Android

    Download WirePod-#.#.#.apk from the latest WirePod release and install it. Installing it does not erase user data.

  • Delete wire-pod data on Debian or Ubuntu

    Stop the wire-pod service, delete /etc/wire-pod/wire-pod, and start the service again. Run wire-pod -justip to open the configuration page without viewing logs.

  • Delete source-installed wire-pod data

    Stop the wire-pod service, enter ~/wire-pod, and delete chipper/apiConfig.json and chipper/jdocs/*.json. Start the wire-pod service again afterward.

  • Open Windows app settings

    Open Settings and find “Apps and Programs.”

  • Uninstall WirePod on Windows

    Find WirePod and uninstall it. The uninstaller will ask whether you want to clear all user data.

  • Reinstall WirePod

    Reinstall WirePod according to the Installation guide.

  • Stop WirePod on macOS

    Make sure WirePod is not running.

  • Delete WirePod data on macOS

    Run the given command in a terminal to delete ~/Library/Application Support/wire-pod.

  • Start WirePod again on macOS

    Start WirePod again.

  • Open Android Settings

    Open Settings.

  • Find WirePod in Android apps

    Go to Apps and find WirePod.

  • Clear Android WirePod data

    Find the option to clear cache and data.

  • Configure wire-pod environment variables

    Place the environment variables in ~/wire-pod/chipper/source.sh and restart wire-pod via start.sh for them to take effect.

  • Set VOSK grammar optimization

    Set VOSK_WITH_GRAMMER to true or false, with a default of false. Enabling it improves speed but limits transcribable words to those that intents can match, so intent-graph functionality will not work.

  • Set the jdocs pinger

    Set JDOCS_ENABLE_PINGER to true or false, with a default of true. When enabled, the jdocs pinger helps production bots stay connected to wire-pod; this requires wire-pod to be able to connect to the robot.

  • Set the web interface port

    Set WEBSERVER_PORT to an integer, with a default of 8080, to set the web interface port.

  • Open the Chipper Web Interface

    Open `http://serverip:8080` in a browser, replacing serverip with the IP address of the machine running the chipper server.

  • Access the Interface Locally

    If the browser is running on the same machine as chipper, open `http://localhost:8080`.

  • Configure Weather and Knowledge APIs

    Change the weather or knowledge graph API configuration on the API setup page.

  • Configure Logged-In Bots

    Open the Configure bots page to configure any bot logged in to the wire-pod instance and its available settings.

  • Create Custom Intents

    Follow the Custom Intents page to create custom intents.

  • Apply DDL ep firmware

    The update applies special firmware compiled by DDL that enables escape pod functionality without paying for escape pod. Check the CCIS page afterward and confirm that the firmware string ends in ep.

  • Enter Vector recovery mode

    For production bots, place Vector on the charger and hold its button for about 15 seconds. It will turn off; keep holding until the lights come back on. This enters recovery mode and does not clear user data.

  • Open the WirePod setup page
  • Download the bot update

    Follow the directions on the setup page. The bot should begin downloading the update.

  • Clear Vector user data

    After the update finishes, clear the bot's user data. The document states that WirePod can technically work without clearing it, but strange behavior will occur.

  • Choose an installation guide

    Follow the guide for your platform, then continue to "Authenticate the bot with wire-pod".

  • Stop other wire-pod instances

    Make sure no other wire-pod instances are running on the network.

  • Open the WirePod releases

    Open the latest WirePod releases page on GitHub.

  • Download the Debian package

    Download the latest wirepod_<arch>-#.#.#.deb package from the releases page.

  • Check the device architecture

    Open a Terminal and run uname -m to determine the device architecture.

  • Select the amd64 package

    If uname -m shows x86_64, use the amd64 package.

Calibrate and test

  • Place Vector on charger

    Place Vector on the charger before clearing its user data.

  • Double-press Vector's button

    Double-press Vector's button while it is on the charger.

  • Move Vector's lift

    Lift his lift up, then down.

  • Select the Vector reset option

    Take Vector off the charger, then twist one wheel until the cursor is on "RESET" or "CLEAR USER DATA".

  • Move the Vector lift

    Lift the lift up, then move it down again.

  • Select the confirmation option

    Move the wheel until the cursor is on "CONFIRM".

  • Confirm the Vector reset

    Lift the lift up, then move it down again to complete the reset action.

  • Open the wire-pod Configuration Page

    Use a device on the same network as wire-pod to open the configuration page in a browser, such as http://192.168.1.221:8080 in the example log. Follow the page instructions to complete setup.

  • Authenticate the Bot with wire-pod

    Continue to the "Authenticate the bot with wire-pod" section near the bottom of the page.

  • Choose the correct authentication path

    Use the production-bot section for a production bot and the unlocked-bot section for an unlocked bot.

  • Open production Bot Setup

    Open the WirePod interface and click "Bot Setup".

  • Follow the production authentication link

    If two sections appear, click the link in the "Authenticate" section and follow the instructions on that page.

  • Run direct production setup

    If only one "Authenticate" section appears, wire-pod can use the detected Bluetooth adapter directly. Follow the instructions; setup runs all necessary stages automatically, and click "Legacy setup" if there are issues.

  • Activate or authenticate production bot

    At the screen with an "ACTIVATE" or "AUTHENTICATE" button, click the button. If an error appears, wait around 20 seconds and try again; it may take several tries.

  • Save production bot settings

    When using the external web page, enter the desired settings and click "SAVE SETTINGS". These settings can be changed later.

  • Confirm production setup completion

    Wait until setup shows "Vector setup is complete!" or a similar message. The bot should then be fully authenticated and set up.

  • Check production authentication troubleshooting

    If authentication causes issues, check the Troubleshooting page.

  • Confirm unlocked bot dev firmware

    Confirm that the bot is already running a development firmware such as WireOS.

  • Open wire-pod web interface

    Open the wire-pod web interface, which is the same configuration page mentioned in the previous section.

  • Open unlocked Bot Setup

    Open the WirePod interface and click "Bot Setup".

  • Set up OSKR or dev bot

    If two sections appear, follow the instructions under "Set up OSKR/dev bot". Afterward, click the link in the top section and follow its instructions.

  • Use direct setup for unlocked bot

    If only one "Authenticate" section appears, wire-pod can use the detected Bluetooth adapter directly. Follow the instructions; setup runs all necessary stages automatically, and click "Legacy setup" if there are issues.

  • Activate or authenticate unlocked bot

    At the screen with an "ACTIVATE" or "AUTHENTICATE" button, click the button. If an error appears, wait around 20 seconds and try again; it may take several tries.

  • Save unlocked bot settings

    When using the external web page, enter the desired settings and click "SAVE SETTINGS". These settings can be changed later.

  • Confirm unlocked setup completion

    Wait until setup shows "Vector setup is complete!" or a similar message. The bot should then be fully authenticated and set up.

  • Connect with the Vector app

    Open the Vector app and let it find and connect to Vector through the signal he emits. Vector will not appear in the smart device's WiFi or Bluetooth settings.

  • Scan home WiFi networks

    Allow Vector to scan for available home WiFi networks in the app, then select the preferred network.

  • Connect to ANKI servers

    After connecting to the preferred WiFi network, Vector connects to the internet to access ANKI's servers.

  • Prepare connected 2.4 GHz WiFi

    Prepare an 802.11n 2.4 GHz WiFi network connected to the Internet through a WiFi access point or NAT router.

  • Unbox and arrange the robot components

    Unbox Vector, his charger, and his Cube on a clean, well-lit surface, or place Vector in his Space.

  • Create a compliant password

    The password must contain at least 8 characters, including one lowercase letter, one uppercase letter, and one number.

  • Exclude special characters from the password

    Do not use special characters in the password.

  • Select an English language variant

    Vector supports only English; select American, British, or Australian English.

  • Place Vector on its charger

    Connect the USB cable on Vector’s charger to a compatible power source, then place Vector on the charger.

  • Enter the date of birth

    Enter your date of birth in Month-Date-Year format. You must be at least 18 to have a Vector account.

  • Choose anonymized usage data collection

    Depending on your region, choose whether to allow ANKI to collect anonymized usage data to improve services.

  • Choose whether to join the newsletter

    Select whether you would like to sign up for the newsletter.

  • Enable Bluetooth and WiFi

    Make sure Bluetooth and WiFi are enabled on your device.

  • Enter Vector's pairing PIN

    Press Vector’s Back Button twice, pressing hard on top of the LED strip until you hear it click, then enter the 6-digit PIN shown on Vector’s screen in the app.

  • Select the home WiFi access point

    After the Vector app connects to the robot wirelessly, select and connect to your home WiFi access point.

Use it

  • Test the customized responses

    After the reboot, ask “What is Area 51?” and then “What is DogeCoin?” to check the customized responses.

  • Control the Robot Remotely

    Open the control page to take control of the robot's behavior, steer it with the keyboard, view the camera stream, and make the robot say things.

  • Open an issue

    If you have another issue, feel free to open an issue. Include a detailed description, hardware details, the steps you have tried, and Vector's complete software version string.

  • Turn Vector Off

    Press the Back Button (the LED strip) down hard until it clicks, and hold it for 5 seconds.

Common problems

  • Installation scripts fail or produce builds that cannot launch. #35 #131 #136 #164 #215 #270
  • Speech recognition dependencies or models fail to download and import. #10 #32 #223 #417
  • Vector cannot activate or connect despite the server being reachable. #134 #162 #198 #252 #275 #285
  • Desktop and mobile clients fail to connect reliably. #47 #234 #509
  • Voice commands intermittently fail, crash, or freeze the service. #83 #86 #445 #452
  • Robot settings no longer apply correctly after upgrading. #76
  • SDK configuration files and external interface calls fail. #36 #147
  • External AI and weather integrations return missing or incorrect responses. #102 #273 #320

Parts

  • Bought assembled: HD camera, four-microphone array, touch sensors, accelerometer and charger (product page)
  • A device on the same network to run wire-pod (requirements in its wiki, not checked)

Tools

  • No printing or soldering

Skills

  • Installing and pairing wire-pod from its wiki
  • Advanced: OSKR to modify behaviours and animations

Software

  • wire-pod (free voice server for Vector 1.0 and 2.0)
  • DDL OSKR

Documents