I have a set of Python tools in a Python toolbox (.pyt). They are broken into multiple files and modules and have been functioning correctly, but now I'm seeing inconsistent behavior on multiple machines.

Basically, I can run the tools from code, I can import and run them from the Python shell in ArcMap, and I can import the toolbox into ArcToolbox through ArcMap and run them from there. But when I browse to the toolbox in ArcCatalog, each of the tools has a red X and when I right click "Why?" it tells me:

AttributeError: 'module' object has no attribute 'Parameter'

I also get the same error if I open the Python shell in ArcCatalog and do:


Although that same command, and subsequent invocation of the tool, works fine in the ArcMap Python console. This is on the first line that references arcpy (this is toolbox_utils.py).

import arcpy

def make_parameter(displayName, name, datatype, defaultValue=None,
              parameterType='Optional', direction='Input'):
    This method prepopulates the paramaeterType
    and direction parameters and leaves the setting a default value for the
    newly created parameter as optional. The displayName, name and datatype are
    the only required inputs.
    # create parameter with a few defaults
    param = arcpy.Parameter(

    # set new parameter to a default value
    param.value = defaultValue

    # return the complete parameter object
    return param

I have tried removing the .pyc files, removing and resetting the .xml metadata files and reducing the tools to a bare minimum. If I put an empty tool in a generic toolbox with no parameters, it works. Once I try to break it into the modules (which were working just fine), I start getting this error. It's as if ArcCatalog isn't resolving the arcpy reference.


Just to make it extra confusing, if I open ArcMap, open the Catalog window in ArcMap and browse to the exact same toolbox, all of the tools work. No red X's. Started and stopped both applications - ArcCatalog gives me the error, Catalog window in ArcMap doesn't.

Also, I checked to make sure ArcMap and ArcCatalog are using the same version of Python and they are both pointed to my Python27\ArcGIS10.3 directory.

Sample Project

If anyone wants to see what I've been doing and offer any improvements, I put the sample project that I whittled my real Toolbox down from on github. If anyone wants to help me expand it into a really tight sample structure, that would be great. https://github.com/cmpalmer66/SamplePythonToolbox

This is my structure:


Toolbox.pyt looks like:

import arcpy

from toolpackages.service_one import ServiceOne
from toolpackages.service_two import ServiceTwo

class Toolbox(object):
    def __init__(self):
        Define the toolbox properties here. Do not change the name of this
        class. ArcGIS locates this class by name. It will not be able to find
        the toolbox and your toolbox will not work if you modify this.
        self.label = 'Toolbox'
        self.alias = 'ABCD'

        # List of tool classes associated with this toolbox
        self.tools = [ServiceOne, ServiceTwo]

The toolpackages directory contains the tool definitions, with the actual code in the services module.

Here is an example of one of the files in toolpackages (just the first few lines):

import service.services as services_main
import arcpy_utils.toolbox_utils as utils

class ServiceOne(object):
    Does Service One
    def __init__(self):
        Define the tool class attributes, including your tool parameters.
        self.label = 'ServiceOne'
        self.canRunInBackground = False
  • How are you importing toolbox_utils from service_one (or any of the other packages)? With the structure given above, your top level directory isn't a package and can't be used with relative imports. I was trying to recreate the situation you have here, but ran into that. Jun 24, 2015 at 17:14
  • Oops, that should be arcpy_utils, not toolbox_utils. Jun 24, 2015 at 17:28
  • Edited to add other code sample
    – CMPalmer
    Jun 24, 2015 at 17:47
  • Ah, OK, I wasn't assuming the top level directory was the current working directory (which in all fairness, ArcGIS does when you add a toolbox). I setup a simple toolbox, with your arcpy_utils module and a tool module arranged in packages as you have and it works fine in both ArcGIS 10.2.1 and ArcGIS Pro (so Python 2.7 and 3.4). Are you sure you haven't redefined arcpy somewhere by mistake? Do you have additional things in your package init? Jun 24, 2015 at 18:44
  • I've decided that ArcGIS is apparently very fragile. I removed all but one of the tools and it worked. Without ANY other code changes, I uncommented the tools in toolbox.pyt and tested each one until they were all uncommented and they all still worked in ArcMap and ArcCatalog. Then I moved the same directory of files to a different machine and... had similar but different problems. Same version. Same code.
    – CMPalmer
    Jun 24, 2015 at 21:17

1 Answer 1


It sounds like an ArcGIS version conflict. Are the toolboxes in a folder that the 10.3.1 ArcCatalog can access? Perhaps you need to "Connect to Folder" first?

This answer also has some suggestions: Esri Python Toolbox(pyt) corruption in ArcToolbox.dat

You can try clearing the ArcToolbox.dat in ~\AppData\Roaming\ESRI\Desktop10.3\ArcToolbox

  • From the linked issue, it sounds like the disabling geoprocessing results history might fix my problem - I had checked or tried all of the other things (including deleting the ArcToolbox.dat). It'll take a while before I can check, since I gave up and wrote Flask services instead, but even if that fixes it, ESRI has some errors to fix. Accepted unless testing proves otherwise.
    – CMPalmer
    Aug 19, 2015 at 18:12

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.