license:apache-2.0 region:us
---
license: apache-2.0
# Copyright 2023 DeepMind Technologies Limited
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# ==============================================================================
---
# Alphageometry Weights and Vocabulary Setup

This repository provides an alternative method for setting up alphageometry, particularly useful for users encountering errors with the `bash download.sh` script from Google Drive.

## Common Error

When running the `download.sh` script, you may encounter the following error:

```bash
bash download.sh
# Error Output:
DATA=ag_ckpt_vocab
Retrieving folder list
Failed to retrieve folder contents:
file/folder name cannot be extracted from: ag_ckpt_vocab – Google Drive
```

## Resolution Steps

1. **Create a Folder:**
   - At the root of your alphageometry folder, create a new folder named `ag_ckpt_vocab`.
     Example: `alphageometry/ag_ckpt_vocab`

2. **Download Required Files:**
   - Download and place the following three files inside your `ag_ckpt_vocab` folder:
     1. `geometry.757.vocab`
     2. `geometry.757.model`
     3. `checkpoint_10999999`

3. **Set Environment Variable:**
   - Open a bash shell at the root of your alphageometry folder.
   - Execute the following command:

     ```bash
     export DATA=ag_ckpt_vocab
     ```

### Alternative to Step 3

Alternatively, you can automate the environment variable setup:

1. Create a file named `extrasetup.sh` in the root of your alphageometry folder.
2. Add the following line to `extrasetup.sh`:

   ```bash
   export DATA=ag_ckpt_vocab
   ```

3. In a bash shell at the root of your alphageometry folder, execute:

   ```bash
   bash extrasetup.sh
   ```
