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